Impeccable（pbakaus/impeccable）は、AIコーディングエージェントが生成するUIに繰り返し現れる「あるある」を、LLMではなく61個の決定論的なルールで機械的に検出するOSSです。GitHubスターは約70,300（2026-09-24時点・急上昇中）まで伸びており、実際にインストールして detect コマンドを動かした結果までこの記事で実測する。

AIが生成したUIをimpeccable detectが61個のルールでスキャンし、overused-font・ai-color-palette・nested-cardsの3件を検出する流れの図解
impeccableの検出フロー。実機検証でInterフォント・紫グラデ・カードonカードの3件が実際に検出された（出典: 本記事の実機検証）。
30秒でわかるImpeccable（2026-09-25時点）
  • ・正体：個人開発者Paul Bakaus氏が公開するRust製の検出エンジン＋TypeScript/Node製CLIのOSS。VSCode拡張・Cursorプラグインなど10以上のツール向けに配布される
  • ・何ができる：Interフォント・紫グラデ・カードonカードなど、AI生成UIに頻出するアンチパターンを61個の決定論的ルールで検出し、修正の方向性を提示する
  • ・実測：npx impeccable install --providers=claude --scope=projectから約16MBのエンジンバイナリのダウンロードまで確認。サンプルHTMLに対してdetectを実行し、overused-font・nested-cards・ai-color-paletteの3件を実際に検出した
  • ・注意：エンジンはENGINE_VERSION 0.1.5でpre-1.0。ライセンスはApache 2.0だがNOTICE.mdにMITライセンスの第三者コンテンツの帰属表記があり、完全オリジナルではない

こうしたAIコーディングエージェント向けのデザイン品質改善は、デザインシステムとは？仕組み・構成要素・有名事例をエンジニア向けに整理する【2026年版】で扱う設計基盤の話とも重なる。本記事ではその中でも「アンチパターンを機械的に検出する」というImpeccable特有のアプローチに絞って解説する。

Impeccableとは——AIコーディングのデザイン品質を機械検出するOSS

Impeccableの実測データ図。GitHubスター約70,300、検出ルール数61、総コミット数1,913、エンジンバージョンv0.1.5をまとめた図
Impeccableの実測データ（2026-09-25時点、リサーチ枠によるWebFetch・git clone実測）。

Impeccableは、Claude Code・Cursor・Codex・Gemini CLIなど10以上のAIコーディングツール向けに配布される「デザインスキル」として設計されている。README上ではAnthropicが公開したfrontend-designスキルが最初の広く使われたデザインスキルであり、Impeccableはそこから派生した経緯だと説明されている（この派生関係の詳細はImpeccable自身のREADMEの記述にとどまり、当サイトでは一次リポジトリまでの追加検証はしていない）。

「AIコーディング デザイン」という文脈で語られるツールには、デザインシステムを持ち込むもの・特定ブランドの美学を教えるもの・そしてImpeccableのように失敗パターンを検出するものという少なくとも3系統がある。「Claude Code デザインスキル」の一種として動く点は共通していても、何を解決しようとしているかはツールごとに異なる。読者が知りたい3点に沿って整理すると次のとおり。

・何ができるか：CLIまたはブラウザ拡張で、対象のHTML/コンポーネントをスキャンし、61個の検出ルールに基づいてAI生成UIにありがちな失敗（没個性なフォント・紫系グラデーション・カードonカードのネストなど）を指摘する
・何を解決するか：デザイナーの目視レビュー待ちや、LLMに「これはAIっぽいですか」と聞いても答えが揺れる曖昧さを、決定論的なルールエンジンに置き換える
・何を代替できるか：単一ブランドの美学を教え込むスキル（後述のNothing Design Skill）や、デザインシステムをまるごと持ち込む仕組み（後述のOpen Design）の代替にはならない。Impeccableが担うのは「与えられた美学の中で、AIが典型的にやらかす失敗を潰す」レイヤーである

仕組み：61個の決定論的検出ルールとライブブラウザ反復

flowchart LR A["AIコーディングエージェントが
UIを生成"] --> B["impeccable detect
（CLI / ブラウザ拡張）"] B --> C{"61個の検出ルールに
一致するか？"} C -- はい --> D["アンチパターンを指摘
（根拠＋修正案）"] C -- いいえ --> E["検出なしで完了"] D --> F["エージェントが修正案を反映"]

Impeccableの本体はRust製の検出エンジンで、crates/以下にcore・detect・browser・comp・html・live・wasmといったクレートが分かれている構成をリサーチ枠が確認済みだ。ディレクトリ名から推測できる範囲では、detectが検出ルール本体、html/compがマークアップ・コンポーネントの解析、browser/liveがブラウザ経由の実行、wasmがブラウザ拡張向けのビルドターゲットを担っていると考えられる（各クレートの実装詳細までは本記事では検証していない）。CLIとVSCode拡張・Cursorプラグインはこのエンジンをラップして各エディタに橋渡しする役割を持つ。ENGINE_VERSIONファイルに記載のエンジンバージョンは0.1.5で、明確にpre-1.0の段階にある。README上では「live browser iteration」（ブラウザ上でのリアルタイム反復）が実験的機能として挙げられており、CLIによる静的スキャンとは別の実行モードとして案内されている。

星数は2026年9月時点で約70,300まで急伸しているが、リサーチ枠の評価では「短期間での急伸はSNS等でのバイラル拡散の影響が大きい可能性があり、実際の導入数とは別軸」とされている。個人名義（pbakaus）のリポジトリでありながら、1,913コミット・複数のRustクレート・複数エディタ統合まで実装されている点は規模として大きいが、実際の開発体制（バス係数）は未確認のままにしておく。

実測：導入からdetectコマンド実行まで（Linux x86_64）

実際にNode.js環境でnpx impeccable installを非対話フラグ付きで実行し、続けてサンプルHTMLに対する検出まで確認した。

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が返る。エンジンのバージョン（0.1.5）と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自体が提供するサブコマンドは--helpで確認する限りdetect（本体機能）・ignores（検出ルールの無視設定管理）・install（今回実行したインストール）・link（ローカルチェックアウトからのスキル参照）・update（スキルの更新）・check（更新の有無確認）・helpの7系統だった。またインストール後の.claude/skills/impeccable/reference/には、audit・critique・polish・shape・delight・colorizeなど35個のコマンド別リファレンスMarkdownが生成されており、単なる検出だけでなくAIコーディングエージェント向けの一連のデザイン作業語彙として設計されていることがうかがえる。

検証環境：Linux（x86_64）／Node.js（npx実行環境）／2026-09-25。npx impeccable installからdetectコマンドの実行、エンジンバイナリのダウンロードと動作までを確認した。/impeccable initなど各AIコーディングエージェント側でのスラッシュコマンド利用や、README記載の「ライブブラウザ反復」機能は本記事では未検証。

注意：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の失敗パターンを検出（アンチパターン検出） 単一ブランドの美学をスキルとして教える デザインシステムをまるごと持ち込む
対応範囲 ブランド非依存・汎用の61ルール Nothingブランド固有のビジュアル言語のみ 複数デザインシステム×複数エージェント対応
ライセンス Apache 2.0（NOTICE.mdにMIT由来コンテンツの帰属あり） MIT 個別確認が必要（本記事では未確認）
開発状況 pre-1.0（v0.1.5）・活発 README上、開発停滞中 別軸のOSSとして継続開発
位置づけ 「与えられた美学の中でAIの失敗を潰す」レイヤー 「特定ブランドの美学を教える」レイヤー 「デザインシステムそのものを与える」レイヤー

Claude Design 使い方ガイド｜始め方・プロンプトのコツ・料金と使用量上限、Claude Codeとの違いで扱うClaude Design（Anthropic公式の有償デザインツール）とも比較対象に挙がりやすいが、こちらは製品カテゴリそのものが異なる。Claude DesignはAnthropicが提供する有償のデザイン生成ツールであり、ImpeccableはOSSの検出エンジンだ。無償で導入できるOSSという軸で比較するなら、単一ブランドを教えるNothing Design Skillや、デザインシステムを持ち込むOpen Designの方が近い競合になる。

目視レビューとimpeccableの比較図。目視レビューは基準が曖昧でLLMの答えが揺れるのに対し、impeccableはCLI/ブラウザ拡張でその場で決定論的に検出し根拠と修正案を提示する
目視レビュー中心の従来アプローチと、決定論的ルールで検出するImpeccableの違い（出典: pbakaus/impeccable README）。

ライセンスと採用判断

Impeccableのリポジトリ全体はApache License 2.0で、LICENSEファイルの原文もApache 2.0本文と一致することをリサーチ枠が確認済みだ。ただしNOTICE.mdには第三者由来コンテンツ（ehmo/platform-design-skills、MITライセンス）の帰属表記があり、「完全に自社オリジナルの実装」と言い切れる状態ではない。採用にあたっては、この帰属表記の存在を踏まえた上でライセンス条項を確認するのが望ましい。

また、CLIは初回実行時に「ランチャーの隣に置くか、初回実行時に1回だけダウンロードする自己完結型バイナリ」を取得する設計だとREADMEに明記されている。今回の実機検証でもインストール時にエンジンバイナリのダウンロードが発生することを確認したが、そのバイナリがRustソース（crates/以下）から実際にビルドされたものと完全に対応しているかまでは検証していない。この対応関係は未確認のまま記載する。

エンジンバージョンが0.1.5というpre-1.0の段階であることも踏まえ、本番のCIパイプラインに組み込むよりは、まずローカルの開発フローで検出結果を確認しながら運用するのが無難な導入ステップになる。Claude Codeデザインスキルの一種として.claude/skills/配下にインストールされる関係上、既存のAIコーディングエージェント運用フローに追加コストなく組み込める点は、AIコーディング×デザインの文脈での採用判断材料になる。

まとめ

Impeccableは、AIコーディングエージェントが量産しがちな没個性なUI（Interフォント・紫グラデ・カードonカード）を、LLMに頼らない61個の決定論的ルールで機械的に検出するOSSだ。単一ブランドの美学を教えるNothing Design Skillや、デザインシステムをまるごと持ち込むOpen Designとは異なり、「与えられた美学の中でAIの典型的な失敗を潰す」という役割に特化している。

向いているのは、既にAIコーディングエージェントで量産的にUIを作っており、「どのAIも同じような見た目になる」という悩みを機械的なチェックで潰したいチーム。エンジンがpre-1.0段階であることや、ライセンス表記に第三者コンテンツが含まれる点を理解した上で、まずはローカルの`detect`コマンドから試すのが実測ベースの結論になる。逆に、デザインシステムそのものが未整備なチームや、単一ブランドの世界観を厳密に守りたいプロジェクトでは、Open DesignやNothing Design Skillのような別アプローチの方が出発点として合っている。

参照ソース

・pbakaus/impeccable（公式リポジトリ・README） — 機能一覧・インストール手順・ライセンス（LICENSE・NOTICE.md）を確認
・Impeccable公式サイト（impeccable.style） — ドキュメント・ケーススタディを確認