インストール
npx impeccable install誰向けか
AI コーディングエージェントに設計指導を足す必要があるとき、Impeccable を見る。公式の要約は:Design guidance for AI coding agents. 1 skill, 23 commands, live browser iteration, and 61 deterministic detector rules for AI-generated frontend design。
すでにフロントエンドプロジェクトがあり、先に安定した製品事実を書き、後続コマンドにその事実で働かせたい人向け。色だけをいじるテーマパックではない。本文は Cursor、Claude Code、Gemini CLI、Codex CLI、Grok Build、Hermes Agent、Veto、および every other supported tool と一緒に使えると列挙する。この名簿を唯一の対応範囲と読まない。
ページ:
https://github.com/pbakaus/impeccable
3 分で最初の試行を終える
公式経路はこの一段だけ。先にプロジェクトルートで実行する:
npx impeccable install
それから AI coding tool で /impeccable init を走らせる。前提:今のディレクトリがプロジェクトルートである。init が製品事実を PRODUCT.md に書くことを受け入れる。他のインストーラや、書いていないスキルディレクトリを発明しない。
最初は読み取り専用照合をする。急いでファイルを書かない。エージェントに確認する:init はどの事実を PRODUCT.md に記すか。それらの事実と視覚方向はどう違うか。成功は、エージェントが audience、purpose、operating context、constraints、voice、evidence を言い、later commands がこれらを surface-level visual direction と混ぜてはいけないと説明すること。
確認できてから /impeccable init を走らせる。成功は、プロジェクトに PRODUCT.md が出て、上記フィールドを覆うこと。
利用例
例 1:先に製品事実を固める。/impeccable init records durable product truth in PRODUCT.md。「誰のために作るか、製品は何をするか、硬い制約は何か、声は何か」をエージェントに渡し、そのファイルへ書かせる。これはファイル変更である。実行前に PRODUCT.md を作成または上書きしてよいか確認する。ページはファイルテンプレート全文を出していない。見出し名以外の構造を作らない。
例 2:決定的規則でフロントエンド設計を点検する。本文は 61 deterministic detector rules と書き、別に LLM-only critique checks もある。The CLI and browser extension run the deterministic rules with no LLM and no API key。画面を一版直したあと、先にモデル無しの規則点検をする向き。いきなり生成的な批評をしない。照合できるのは、この点検が LLM を使わず API key も求めないと宣言すること。23 本のコマンドの具体名はページに無い。発明しない。
利用上の境界
インストールはプロジェクトルートから始め、それから /impeccable init。二歩を競合する二本の主インストーラに分けない。
PRODUCT.md が記すのは耐久する製品事実であり、視覚スタイルの説明書ではない。
CLI とブラウザ拡張が決定的規則を走らせるとき、LLM も API key も要らない。LLM-only critique は別種の点検である。同一步に混ぜない。
クライアントは原文どおり列挙され、every other supported tool を含む。そのうち一つだけ対応と書かない。書いていないコマンド名、規則明細、ライブブラウザ操作手順を補わない。