Impeccable（pbakaus/impeccable）は、AIコーディングエージェントが生成するUIに繰り返し現れる「あるある」を、LLMではなく62個の決定論的なルールで機械的に検出するOSSです。GitHubスターは約86,700（2026-10-25時点・GitHub日榜で急騰中）まで伸び、公開から約1か月で約70,300から大きく積み増した。検出ルールに加えて、polish・audit・critiqueといった24個のデザインコマンドと、ブラウザ上で見た目を反復するライブモードまで備える「デザインスキル」へと広がっている。本記事では実際にインストールして detect を動かした結果と、公開1か月後の現状を実測で整理する。
- ・正体：個人開発者Paul Bakaus氏が公開するRust製の検出エンジン＋ランチャーバイナリのOSS。Claude Code・Cursor・Codex・Gemini CLIなど多数のツール向けに配布される
- ・何ができる：Interフォント・紫グラデ・カードonカードなど、AI生成UIに頻出するアンチパターンを62個の決定論的ルールで検出し、polish・audit・critiqueなど24個のデザインコマンドで修正まで回す
- ・この1か月の変化：GitHubスターが約70,300→約86,700に急騰。検出ルールは61→62個、エンジンはv0.1.5→v0.1.17、CLIパッケージは4.0.0→4.7.1（Release 4.7.1・2026-10-23）に進んだ
- ・注意：エンジンはENGINE_VERSION 0.1.17でpre-1.0。ライセンスはApache 2.0だがNOTICE.mdにMITライセンスの第三者コンテンツ（iOS・Android参照ファイル）の帰属表記があり、完全オリジナルではない
こうしたAIコーディングエージェント向けのデザイン品質改善は、デザインシステムとは？仕組み・構成要素・有名事例をエンジニア向けに整理する【2026年版】で扱う設計基盤の話とも重なる。本記事ではその中でも「アンチパターンを機械的に検出する」というImpeccable特有のアプローチに絞って解説する。
Impeccableとは——AIコーディングのデザイン品質を機械検出するOSS
ImpeccableはClaude Code・Cursor・Codex・Gemini CLIに加え、Grok Build・Hermes Agent・Veto・GitHub Copilot（VS Code拡張）など多数のAIコーディングツール向けに配布される「デザインスキル」として設計されている。README上ではAnthropicが公開したfrontend-designスキルが最初の広く使われたデザインスキルであり、Impeccableはそこから派生した経緯だと説明されている（この派生関係の詳細はImpeccable自身のREADMEの記述にとどまり、当サイトでは一次リポジトリまでの追加検証はしていない）。公開当初は「検出」が中心だったが、現在は/impeccable initでプロジェクトの前提をPRODUCT.mdに記録し、polish・audit・critique・distill・animateといった24個のコマンドをAIと共有の設計語彙として使う構成に広がっている。
「AIコーディング デザイン」という文脈で語られるツールには、デザインシステムを持ち込むもの・特定ブランドの美学を教えるもの・そしてImpeccableのように失敗パターンを検出するものという少なくとも3系統がある。「Claude Code デザインスキル」の一種として動く点は共通していても、何を解決しようとしているかはツールごとに異なる。読者が知りたい3点に沿って整理すると次のとおり。
・何ができるか：CLIまたはブラウザ拡張で、対象のHTML/コンポーネントをスキャンし、62個の検出ルールに基づいてAI生成UIにありがちな失敗（没個性なフォント・紫系グラデーション・カードonカードのネストなど）を指摘する
・何を解決するか：デザイナーの目視レビュー待ちや、LLMに「これはAIっぽいですか」と聞いても答えが揺れる曖昧さを、決定論的なルールエンジンに置き換える
・何を代替できるか：単一ブランドの美学を教え込むスキル（後述のNothing Design Skill）や、デザインシステムをまるごと持ち込む仕組み（後述のOpen Design）の代替にはならない。Impeccableが担うのは「与えられた美学の中で、AIが典型的にやらかす失敗を潰す」レイヤーである
仕組み：62個の決定論的検出ルールとライブブラウザ反復
Impeccableの本体はRust製の検出エンジンで、crates/以下にcore・detect・foundation・comp・html・browser・live・wasmなど複数のクレートが分かれている構成をgit cloneで確認した。検出ルールの定義本体はcrates/foundation/src/registry.rsにあり、実際に数えるとルールIDは62個で、READMEが掲げる「62 deterministic detector rules」と一致する。ルールは「AI生成UI特有の『AIっぽさ』（purpleグラデ・側タブの枠線・bounceイージングなど）」と「汎用的なデザイン品質（行長・詰まったパディング・小さいタッチ領域・見出しの飛ばしなど）」の2系統にまたがる。CLIと各エディタ向けスキルはこのエンジンをラップして橋渡しする役割を持つ。ENGINE_VERSIONファイルのエンジンバージョンは0.1.17（公開当初は0.1.5）で、依然pre-1.0の段階にある。一方でnpmパッケージ（CLI）のバージョンはpackage.jsonで4.7.1（Release 4.7.1・2026-10-23）まで進んでおり、エンジンとCLIの版番号が別管理である点は変わらない。README上では「live browser iteration（ライブブラウザ反復）」が看板機能の一つに格上げされ、/impeccable live・/impeccable generateとしてローカルの開発サーバ経由でブラウザ上の要素を反復する専用モードが用意されている（本番サイトへの適用は非対応とドキュメントに明記）。
星数は公開当初（2026年9月）の約70,300から、2026-10-25時点で約86,700（GitHubページ上の表示）まで伸び、GitHubの日榜（1日あたりの獲得スター）でも上位に出ている。ただし短期間での急伸はSNS等でのバイラル拡散の影響が大きい可能性があり、実際の導入数とは別軸で見るべきだ。個人名義（pbakaus）のリポジトリでありながら、複数のRustクレート・多数のエディタ統合まで実装されている点は規模として大きいが、実際の開発体制（バス係数）は未確認のままにしておく。
実測：導入からdetectコマンド実行まで（Linux x86_64）
公開当初（2026-09-25・CLI v4.0.0）に、Node.js環境でnpx impeccable installを非対話フラグ付きで実行し、続けてサンプルHTMLに対する検出まで確認した。以下はそのときの実機ログで、挙動の骨格は現行版（CLIパッケージ4.7.1）でも同じだが、エンジンバイナリの配置先などは版によって変わりうる点に注意してほしい。
npx --yes impeccable install --providers=claude --scope=project
実行すると、スキルとエンジンバイナリのダウンロードが走り、.claude/skills/impeccable/scripts/bin/linux-x64/impeccableという約16MBの実行ファイルが設置された。インストール先はプロジェクト直下の.claudeディレクトリで、エージェント用のフック・agentsファイルを含め56ファイルが生成された（合計約18MB）。
./.claude/skills/impeccable/scripts/bin/linux-x64/impeccable --version
このコマンドでは当時のCLIバージョン4.0.0が返った。現在はnpmパッケージが4.7.1まで進んでおり、エンジンのバージョン（当時0.1.5／現行0.1.17）とCLIのバージョン番号が別管理になっている構造は変わっていない。
installコマンドは対話的にプロバイダ（Claude Code / Cursor / Codex等）とインストール範囲（プロジェクト/グローバル）を尋ねる設計になっているが、README記載のとおり--providers=と--scope=フラグを渡すことでCI環境やサンドボックスでも非対話実行できる。これはAI生成UI品質のチェックをエージェントの作業フローに組み込む上で重要な実装上のポイントだ。
続けて、Interフォント・紫グラデ・カードonカードを意図的に仕込んだサンプルHTMLに対して検出を実行した。
./.claude/skills/impeccable/scripts/bin/linux-x64/impeccable detect sample/index.html
出力は次の3件で、AI生成UIの「あるある」をそのまま言い当てる内容だった。
・overused-font：Interフォントの使用を指摘し「AI生成UIの新しい波は毎回同じ顔（Inter・Roboto・Fraunces等）に収束する」という趣旨の説明を返す
・nested-cards：カード内カードの入れ子構造を「視覚的ノイズと過剰な深さを生む」として指摘
・ai-color-palette：紫/バイオレット系のグラデーションを「AI生成UIの最も分かりやすい特徴の一つ」として指摘
CLIが提供するサブコマンドは、現行リポジトリのcrates/cliで確認するとdetect（本体機能）・ignores（検出ルールの無視設定）・install・link（ローカルチェックアウトからの参照）・update・check（更新の有無確認）・doctor（環境診断）・helpの8系統で、公開当初の7系統にdoctorが加わっている。一方で、AIコーディングエージェント側から/impeccable <command>として呼ぶデザインコマンドは、READMEのコマンド表でpolish・audit・critique・shape・distill・animate・bolder・quieter・live・generateなど24個にまとめられている。/impeccable initでプロジェクトの前提（対象ユーザー・目的・制約・声）をPRODUCT.mdに書き出し、既存のデザインシステムはDESIGN.mdに記録する。この「検出の前に文脈を固める」導線が加わった点が、公開当初からの最も大きな構成変化だ。
検証環境：Linux（x86_64）／Node.js（npx実行環境）／導入とdetectは2026-09-25に実機確認（CLI v4.0.0）。2026-10-25の更新では、ルール数・コマンド数・各種バージョンをgit cloneした現行リポジトリのソース（crates/foundation/src/registry.rs・README.md・ENGINE_VERSION・package.json）とGitHubページで突き合わせた。/impeccable initや/impeccable liveなどエージェント側のスラッシュコマンドの対話実行、README記載の「ライブブラウザ反復（live mode）」の実動作は本記事では未検証。
注意：VSCode拡張はMarketplace上でrenaissance-geekという公開名義で配布されている。これが開発者本人（pbakaus）と同一名義かは未確認のため、断定せず「公開名義はrenaissance-geek」とだけ記載する。
類似ツールとの比較
「AIコーディングエージェント向けのデザインガイダンス」という領域には、アプローチの異なる複数のツールが存在する。単一ブランドの美学を教えるNothing Design Skillとは｜Claude Codeにブランド設計原則を教えるスキルや、デザインシステムをまるごと持ち込むOpen Design（nexu-io）とは｜手元のコーディングエージェントが回すOSSデザイン工房【動画解説】は、Impeccableと同じ「AIコーディング×デザイン」の文脈で語られやすいが、アプローチはそれぞれ異なる。
| 観点 | Impeccable | Nothing Design Skill | Open Design |
|---|---|---|---|
| アプローチ | AI生成UIの失敗パターンを検出（アンチパターン検出） | 単一ブランドの美学をスキルとして教える | デザインシステムをまるごと持ち込む |
| 対応範囲 | ブランド非依存・汎用の62ルール＋24コマンド | Nothingブランド固有のビジュアル言語のみ | 複数デザインシステム×複数エージェント対応 |
| ライセンス | Apache 2.0（NOTICE.mdにMIT由来コンテンツの帰属あり） | MIT | 個別確認が必要（本記事では未確認） |
| 開発状況 | pre-1.0（エンジンv0.1.17／CLI 4.7.1）・活発 | README上、開発停滞中 | 別軸のOSSとして継続開発 |
| 位置づけ | 「与えられた美学の中でAIの失敗を潰す」レイヤー | 「特定ブランドの美学を教える」レイヤー | 「デザインシステムそのものを与える」レイヤー |
Claude Design 使い方ガイド｜始め方・プロンプトのコツ・料金と使用量上限、Claude Codeとの違いで扱うClaude Design（Anthropic公式の有償デザインツール）とも比較対象に挙がりやすいが、こちらは製品カテゴリそのものが異なる。Claude DesignはAnthropicが提供する有償のデザイン生成ツールであり、ImpeccableはOSSの検出エンジンだ。無償で導入できるOSSという軸で比較するなら、単一ブランドを教えるNothing Design Skillや、デザインシステムを持ち込むOpen Designの方が近い競合になる。
ライセンスと採用判断
Impeccableのリポジトリ全体はApache License 2.0で、LICENSEファイルの原文もApache 2.0本文と一致することをリサーチ枠が確認済みだ。ただしNOTICE.mdには第三者由来コンテンツ（ehmo/platform-design-skills、MITライセンス）の帰属表記があり、「完全に自社オリジナルの実装」と言い切れる状態ではない。採用にあたっては、この帰属表記の存在を踏まえた上でライセンス条項を確認するのが望ましい。
また、CLIは初回実行時に「ランチャーの隣に置くか、初回実行時に1回だけダウンロードする自己完結型バイナリ」を取得する設計だとREADMEに明記されている。今回の実機検証でもインストール時にエンジンバイナリのダウンロードが発生することを確認したが、そのバイナリがRustソース（crates/以下）から実際にビルドされたものと完全に対応しているかまでは検証していない。この対応関係は未確認のまま記載する。
エンジンバージョンが0.1.17というpre-1.0の段階であることも踏まえ、本番のCIパイプラインに組み込むよりは、まずローカルの開発フローで検出結果を確認しながら運用するのが無難な導入ステップになる。検出ルールが決定論的であっても、それは「典型的な失敗を機械的に弾ける」という意味であって、設計の良し悪しそのものを保証するものではない点は押さえておきたい。Claude Codeデザインスキルの一種として.claude/skills/配下にインストールされる関係上、既存のAIコーディングエージェント運用フローに追加コストなく組み込める点は、AIコーディング×デザインの文脈での採用判断材料になる。
まとめ
向いているのは、既にAIコーディングエージェントで量産的にUIを作っており、「どのAIも同じような見た目になる」という悩みを機械的なチェックで潰したいチーム。エンジンがpre-1.0段階であることや、ライセンス表記に第三者コンテンツが含まれる点を理解した上で、まずはローカルの
detectコマンドから試すのが実測ベースの結論になる。逆に、デザインシステムそのものが未整備なチームや、単一ブランドの世界観を厳密に守りたいプロジェクトでは、Open DesignやNothing Design Skillのような別アプローチの方が出発点として合っている。
参照ソース
・pbakaus/impeccable（公式リポジトリ・README） — 機能一覧・インストール手順・ライセンス（LICENSE・NOTICE.md）を確認
・Impeccable公式サイト（impeccable.style） — ドキュメント・ケーススタディを確認
