Impeccable は ArtCraft ではなく ArtCraft の製品やスイートの一部でもなく、本ページは独立ガイドです;最新情報は impeccable.style と github.com/pbakaus/impeccable を参照してください。

Impeccable:コーディングエージェントのためのデザイン語彙

Impeccable は、コーディングエージェントが同じ語彙で UI をレビューし、整え、仕上げるためのオープンソースのスキルと CLI です。Paul Bakaus が作成し、Anthropic の frontend-design スキルを出発点にしています。ライセンスは Apache-2.0。このページは公式ドキュメントではなく、独立したガイドです。

公式サイトGitHub リポジトリ公式ドキュメント

最終更新: · English

Impeccable を使わずに構築した Villa Castagneto のページ。クリーム色の背景、斜体アクセント付きの細いセリフ見出し、2 つのピルボタン、角丸カードに入ったフラットなベクターイラスト。
公式 README の作例:同じ民宿のブリーフと同じモデルで、Impeccable なしの場合。クリーム色、セリフ、ピルボタンという「無難な既定」に落ち着いている。

Impeccable とは

Impeccable は、コーディングエージェントに「デザインの語彙」を与えるスキルと、単体で動く CLI です。キャンバスを開く代わりに、デザインをエージェントが実行できるコマンドに分解します。批評し、収束させ、タイポグラフィを整え、削り、堅牢にする、という流れです。作者は Paul Bakaus で、Anthropic の frontend-design スキルを起点に、Apache-2.0 で公開されています。

狙っているのは「エージェントの既定の審美」です。どこもかしこも Inter、紫から青のグラデーション、カードの中のカード、色背景の上のグレー文字、見出しごとの角丸アイコンタイル。62 の決定論的ルールがこうした兆候を編集時に拾い、LLM も API キーも使いません。

得意なのは、すでにあるインターフェースです。ページやコンポーネントを指定して反復するほうが、ゼロからサイト全体を作るより安定します。新規制作もできますが、公式もそちらは難しいモードだと認めています。なお Impeccable は独立したオープンソースプロジェクトであり、ArtCraft の製品でもスイートの一部でもありません。

インストールと初期化

プロジェクトのルートで次のコマンドを実行します。npx には Node 18.19 以上が必要です。インストーラーが利用中のコーディングツールを検出し、プロジェクト単位かグローバルかを尋ね、対応ツールではデザインフックを提案します。フックは有効にしておくのがおすすめです。

完了したらツールを再読み込みし、/impeccable init を実行します(Codex では $impeccable init)。スクリプトから入れる場合は --providers=claude,codex,cursor と --scope=project|global を渡せます。既存の導入は npx impeccable update で更新できます。

npx impeccable install
  1. Node 18.19 以上を用意し、プロジェクトのルートに移動する。
  2. npx impeccable install を実行し、プロジェクト範囲かグローバル範囲かを選ぶ。対応ツールならデザインフックも有効にする。
  3. コーディングツールを再読み込みし、/impeccable init(Codex は $impeccable init)を実行して PRODUCT.md を生成する。
  4. 必要なら /impeccable document で DESIGN.md を作り、以後は npx impeccable update で更新する。

主要コマンド

コマンドは全部で 24 あります。「コマンド+対象」の形で使い、たとえば /impeccable critique the pricing cards です。Codex ではスラッシュの代わりに $ を付けます。/impeccable だけを入力すると一覧が出ます。以下は特によく使う 7 つです。

コマンド役割使う場面
/impeccable initコードを読み、推測できないことだけを質問して PRODUCT.md を書き出す。プロジェクト開始時に 1 回。以降のコマンドの前提になる。
/impeccable critiqueユーザビリティのヒューリスティックに沿って採点付きの UX レビューを行い、直す順番を示す。改修前の現状評価や、フローのどこが詰まっているかの特定に。
/impeccable polish出荷前の最終仕上げ。機能が固まり、リリース直前のタイミングで。
/impeccable auditアクセシビリティ、パフォーマンス、テーマ、レスポンシブ、実装の整合性を技術レポートにまとめ、P0〜P3 で優先度を付ける。リリース前の品質確認や、溜まった実装負債の洗い出しに。
/impeccable typesetフォント、階層、サイズ、余白を整える。文字組みが緩い、階層が曖昧、サイズのリズムが崩れているとき。
/impeccable distillページに不要な要素を削る。情報を詰め込みすぎて焦点がぼやけているとき。
/impeccable hooks status|on|offデザインフックの状態確認・有効化・無効化。フックはエージェントが UI ファイルを編集するたびに走る。自動チェックが効いているか確認したいとき、一時的に止めたいとき。

おすすめの進め方

まず文脈、次に画面です。init は推測できないこと、つまり誰のための製品か、何を達成するか、制約は何かだけを尋ね、答えを PRODUCT.md に書きます。以後のコマンドはこれを読みます。既存のビジュアル体系があるなら document も実行し、ブランド規則を DESIGN.md に残しておくと、途中で路線がぶれにくくなります。

対象は狭くするほど結果が良くなります。「ページ全体を作り直して」より、「critique で料金カードを見て」のほうが精度が上がります。よく使うコマンドは /impeccable pin audit で /audit というショートカットにでき、出荷前は audit → polish の順で締めます。

  1. プロジェクトごとに /impeccable init を 1 回実行し、PRODUCT.md の内容を確認する。
  2. 既存のデザイン規則がある場合は /impeccable document を実行し、フォントや色、コンポーネントの決まりを DESIGN.md にまとめる。
  3. セクション単位で反復する。/impeccable critique the pricing cards のあと、bolder、quieter、distill、typeset で方向を調整する。
  4. 公開前に /impeccable audit と /impeccable polish を順に実行し、常用コマンドを pin しておく。

対応するコーディングエージェント

公式に対応をうたっているツールは広範です。Claude Code、Cursor、Codex CLI、GitHub Copilot、Devin、Replit Agent、Gemini CLI、Grok Build、OpenCode、Google Antigravity、Kiro、Trae、Rovo Dev、Qoder、Mistral Vibe、Pi、Hermes Agent、DeepSeek Harness、Veto。導入方法はツールごとに異なるため、完全な一覧は公式ドキュメントを確認してください。

Claude Code、Copilot、Grok にはプラグインがあり、デザインフックは Claude Code、Cursor、Codex、GitHub Copilot、Grok Build、Hermes Agent で利用できます。Codex は /hooks でプロジェクトフックを承認し、Grok Build は /hooks-trust、Hermes はプラグインの有効化が別途必要です。

Node を入れたくない場合はスキルフォルダを手動でコピーする方法もあります。検出器だけなら npx impeccable detect でエージェント不要です。ライブモードは Vite、Next、SvelteKit、Astro、Nuxt、素の HTML に対応しますが、編集するのはローカルの作業コピーだけです。

Impeccable を使って構築した Villa Castagneto のページ。崖の上の別荘を海から望む全幅の銅版画風夜景、クリーム色と朱色の凝縮された見出し、下端の月別ストリップ。
公式 README の作例:同じブリーフで Impeccable を使った場合。ページ全体が 1 枚の絵、つまり海から見た夜の邸宅を中心に組み立てられている。

Impeccable と ArtCraft MCP の違い

どちらも「エージェントで何かを作る」ためのものなので混同しやすいのですが、層が違います。Impeccable は UI のソースコードを扱い、ArtCraft MCP は storytold による公式のアプリ別 MCP/CLI で、PhotoCraft などのローカル Crafting Apps を動かします。コミュニティの同名 artcraft-mcp サブスクリプション API とも別物です。

観点ImpeccableArtCraft MCP
対象リポジトリ内のフロントエンドのソースコード:コンポーネント、JSX/TSX、CSS、ページ構造。ローカルの Crafting Apps(PhotoCraft など)と、その画像・動画ワークフロー。
出力デザイン助言、コード修正、critique/audit レポート、PRODUCT.md と DESIGN.md。画像・動画素材と、該当アプリ内で実行する自動操作。
選ぶ基準フロントエンド UI を作る、レビューする、仕上げるとき。画像や動画をまとめて生成・処理し、アプリの作業を自動化したいとき。
併用可能。UI は Impeccable、素材制作は ArtCraft MCP に任せる。可能。ただしメディア資産の担当で、UI デザインレビューは行わず、Impeccable の代わりにはならない。

ArtCraft MCP ガイドCrafting Apps

境界と安全性

Impeccable はフロントエンド向けのデザインスキルと CLI であり、デザインアプリでも画像生成器でもありません。ライブモードが編集するのはローカルの作業コピーだけです。デプロイ済みサイトに注入したり、動作させるために本番の CSP を緩めたりしないでください。

フックはモデルの承認とは別に動きます。Claude Code では、モデル自身のコマンドを拒否しても、インストール済みのコマンドフックが実行され、最初の編集でエンジンをダウンロードすることがあります。無人実行の前にフックを確認し、必要なら --settings '{"disableAllHooks": true}' で一時的に切ってください。

テレメトリーが記録するのは、どのビジュアル方向が提示され、どれが選ばれたかという匿名情報です。プロジェクト名、ファイル、コード、PRODUCT.md は送信されません。npx impeccable telemetry off、DO_NOT_TRACK=1、または .impeccable/config.json の "telemetry": false で無効にできます。検出器の終了コードは、2 が指摘あり、1 がスキャン不能です。

関連ガイド

よくある質問

Impeccable とは何ですか。ArtCraft の製品ですか?

Impeccable は Paul Bakaus が開発した、コーディングエージェント向けのデザインスキルと CLI です。24 のコマンドと 62 の決定論的ルールを備え、Apache-2.0 で公開されています。ArtCraft の製品ではなく、ArtCraft スイートの一部でもありません。公式情報は impeccable.style と github.com/pbakaus/impeccable にあります。

インストール方法を教えてください。

プロジェクトのルートで npx impeccable install を実行し、ツールを再読み込みしてから /impeccable init(Codex は $impeccable init)を走らせます。npx には Node 18.19 以上が必要で、既存の導入は npx impeccable update で更新できます。詳しい手順は impeccable.style/docs にあります。

critique と audit はどう違いますか?

critique はユーザビリティのヒューリスティックに基づく採点付き UX レビューで、優先して直すべき点を示します。audit はアクセシビリティ、パフォーマンス、テーマ、レスポンシブ、実装の整合性を点検する技術レポートで、P0 から P3 の順に分類します。体験の判断が critique、実装の点検が audit と考えると整理しやすいです。

API キーは必要ですか?

検出器には不要です。62 のルールはすべて決定論的で、LLM も API キーも使いません。スキル自体もエージェントの中で動くため、別途モデルの鍵を用意する必要はありません。テレメトリーは npx impeccable telemetry off か DO_NOT_TRACK=1 で切れます。

どのコーディングエージェントに対応していますか?

Claude Code、Cursor、Codex CLI、GitHub Copilot、Devin、Replit Agent、Gemini CLI、Grok Build、OpenCode、Google Antigravity、Kiro、Trae、Rovo Dev、Qoder、Mistral Vibe、Pi、Hermes Agent、DeepSeek Harness、Veto です。フックの対応や導入手順はツールごとに違うので、一覧は impeccable.style/docs を確認してください。

ArtCraft MCP とはどちらを選ぶべきですか?

目的で決めます。Impeccable はフロントエンドのソースを対象に、デザイン助言やコード修正、レビューを返します。ArtCraft MCP は PhotoCraft などのローカル Crafting Apps を動かし、画像・動画の生成やアプリ操作を自動化します。併用はできますが、ArtCraft MCP はデザインレビュー用ではなく、Impeccable の代替にもなりません。

独立に関する声明

Impeccable は Paul Bakaus が作った独立のオープンソースプロジェクトで、ArtCraft との資本・運営・開発上の関係はありません。ArtCraft の製品、スイート、公式コンポーネントでもありません。本ページは第三者が日本語読者向けに書いたガイドであり、コマンドや対応範囲、仕様は公式サイト impeccable.style とリポジトリ github.com/pbakaus/impeccable の情報が優先です。ArtCraft MCP は Crafting Apps 向けの別の公式連携で、解こうとしている課題が異なります。

Sources

Every fact on this page comes from the pages below, checked on 3 November 2026.