remove-ai-slop

流行しているモチーフの一覧だけでなく、実際のインターフェイスを監査してください。見てすぐ分かる既定パターンは、はっきり取り除いてください。より目立たないパターンは、プロダクト、コンテンツ、ブランドに合っているのか、それとも学習済みのテンプレートを繰り返しているだけなのかを基準に判断してください。

整理を、別の画一的なスタイルに置き換えてはいけません。すべてのインターフェイスを、デフォルトでフラット、ダーク、角丸を最小限にしたもの、またはモノクロにしてはいけません。

3つの判定を使う

HARD BAN

以下に定める、未完成のコピー、意味の重複、重大な曖昧さ、捏造された証拠、または同様に客観的な定義にのみ使ってください。1件でも確認できれば十分です。視覚的な好み、一般的なコンポーネント、形状、フォント、装飾的なモチーフは、それだけでは該当しません。

この判定を使います。

HARD BAN — [パターン]。[問題点]。取り除いてください。[修正の方向性]。

そのパターンに記載された限定的な意味上の例外のみ認めてください。「ブランド上の選択である」ことは、それだけでは根拠になりません。

STRONG PRESUMPTION

適切に使える場合もありますが、裏付けがない場合や繰り返し使われている場合に、既定パターンのように見えるものに使います。残すには、具体的なプロダクト、コンテンツ、機能、または文書化されたブランド上の理由を求めてください。

この判定を使います。

STRONG PRESUMPTION — [パターン]は、[根拠]により再利用された既定パターンのように見えます。[具体的な目的]がある場合に限り残し、それ以外の場合は[修正]してください。

CONTEXTUAL SIGNAL

中立的なデザインやコピーの語彙が、反復、不一致、併用、または支配的な使われ方によって初めて粗雑さにつながる場合に使います。確信度の低いモチーフが単独で見られるだけなら、欠陥として報告しないでください。

アクセシビリティ、セマンティクス、パフォーマンス、事実の正確性に関する欠陥は、別のQUALITY DEFECTSセクションに記載してください。重要な問題ですが、AI が作成したことの証拠ではありません。

Phase 1：コンテキストを把握する

リポジトリを調べる前に、監査範囲を選んでください。

• Focused — 1つのルート、コンポーネント群、フロー、または報告されたパターンを対象にします。その範囲内の意味のあるすべての状態を調べてください。
• Representative — プロダクト全体のレビューでは、これをデフォルトにします。各ページの役割、共通のクローム、主要なコンポーネントシステム、リスクの高いフローをサンプリングし、関連ページをすべて描画せずにパターンの収束を確認できるだけのルートを含めてください。
• Exhaustive — 対象範囲内のすべてのルート、ロケール、チャネル、意味のある状態を調べます。ユーザーが明示的に完全な網羅を求めている場合、または規制対応、リリース阻止、移行作業によってコストが正当化される場合に使ってください。

リクエストとリポジトリから、必要十分な最小の範囲を推定してください。対象、除外事項、サンプリングの根拠、利用できない状態を明記してください。発見事項が共有ソースに起因する可能性がある場合、または求められる確信度を満たす必要がある場合に限り、範囲を広げてください。

好みを判断する前に、リポジトリの根拠を確認してください。

• README、プロダクト概要、デザインドキュメント、ルート構成、既存のコピー、デザイントークン、フォント設定、ロゴ、ファーストパーティのアセットを確認してください。
• プロダクト、対象ユーザー、主要なタスク、意図されたトーン、重要なブランド上の制約を特定してください。不明な情報はunknownとし、ブランドのストーリーを作り上げてはいけません。
• 各ルートに、マーケティング、料金、ドキュメント、ダッシュボード、設定、オンボーディング、アカウント管理などの役割を割り当ててください。
• 各ルートの主要なアクションとコンテンツの形を記録してください。
• ルートを比較する際は、共有のナビゲーションやフッターのクロームと、ページ固有の構成を分けてください。

選択した範囲を省略せずに、関連するソースを特定してください。

rg --files \
  -g '*.{tsx,jsx,ts,js,css,scss,sass,less,html,vue,svelte,astro,md,mdx,json,yaml,yml}' \
  -g '!node_modules/**' -g '!.next/**' -g '!dist/**' -g '!build/**'

選択した範囲に影響するテーマファイル、コンポーネントライブラリのオーバーライド、コンテンツファイル、アセットマニフェストを含めてください。無関係なアプリケーションコードを避けるため、依存関係とルート構成を活用してください。

フェーズ 2：レンダリング結果を確認する

リポジトリに安全な開発用コマンドがある場合は、既存のアプリケーションを実行します。対象を絞ったモードでは、対象範囲内の意味のある状態をすべて記録します。代表的な状態を確認するモードでは、疑わしい問題を明らかにできるビューポートと状態で、各ページの役割と共有システムのそれぞれを記録します。網羅的なモードでは、ルート／状態マトリクスを使用して、確認範囲を記録します。

レンダリング結果に基づく指摘ごとに、次を記録します。

• ルート、ビューポート、状態
• スクリーンショット、またはレンダリング結果の詳細な説明
• ソースファイルと行番号
• 参考になる場合は、算出されたスタイルまたはコンポーネントの根拠

レンダリングできない場合は、外観に依存する指摘に次のラベルを付けます。

候補 — レンダリングによる確認はできていません。

クラス名だけを根拠に、視覚的な優位性、階層の不備、または構成の悪さを断定しないでください。

フェーズ 3：確度の高い不具合とデフォルトを見つける

1. 装飾的な全大文字のアイブロー

H1 または H2 のすぐ上にある短いラベルが、次の条件を満たす場合、強い推定として扱います。

• 大文字のテキスト、または text-transform: uppercase を使用している
• 太さ 600 以上、高いコントラスト、アクセントカラー、広い字間、ドット、または装飾的な罫線を使って、重要さを演出している
• 見出し、ルート、または周囲のナビゲーション以外の情報を加えていない

FEATURES、WHY US、OUR PLATFORM、MANUAL PAGE、INTRODUCING などのラベルは、その下の内容を告知するだけの場合、装飾的な候補として扱います。繰り返しの使用、視覚的な優位性、または確立された階層との不一致があれば、確度が高まります。単独での使用だけでは、システム全体の問題とは断定できません。

LIVE、ERROR、BETA、権限の状態、バージョンなど、実際に意味があり、重複しないステータスまたは運用メタデータのみ許容します。一般的な頭字語は指摘しないでください。

デフォルトの判定：

強い推定 — 装飾的な全大文字のアイブローです。［根拠］から、情報を加えずに強調を加えているように見えます。ナビゲーション、ステータス、またはブランド上の役割が文書化されていない限り、削除するか目立たなくしてください。

2. 一貫性のない、または誤用されたフォント

読みやすさや意味上の一貫性が損なわれている場合、タイポグラフィを品質上の不具合として報告します。また、役割による裏付けがない状態で、次のいずれかに該当する場合は、テンプレートの寄せ集めである強い推定として報告します。

• 役割が明示され、安定して定義されているわけではないのに、3 種類以上のフォントファミリーが目に見える形で使われている
• 同じ意味上の役割に、コンポーネントやルートによって異なるフォントファミリーが使われている
• デザインのトークンにないフォントを、コンポーネントが一度だけ使用している
• セリフ体、イタリック体、等幅体、スクリプト体、またはディスプレイ体が、意味上の理由なく単独の語を装飾している
• ノベルティ書体、コンデンス書体、スクリプト体、またはディスプレイ書体が、段落、ナビゲーション、コントロール、テーブル、または情報密度の高い製品 UI に使われている

ワードマーク、実際のコードやターミナルの内容、数式表記、および特定のコンテンツに限定して使用される言語固有のフォールバックは許容します。

デフォルトの判定：

強い推定 — 一貫性のないタイポグラフィシステムです。これらのフォントの変更には、確認したシステム内で安定した役割がありません。製品や言語上の根拠によって違いが説明できない限り、明確な役割に統合してください。

修正では、1 種類のフォントファミリー、または意図的に組み合わせた 2 種類に、必要に応じて等幅体を加えてください。役割はトークンとして定義します。すべてを自動的に Inter または Geist に置き換えないでください。

3. 汎用的な角丸ボタン、またはピル型ボタン

次のいずれかに該当し、レンダリング結果から製品のアクション階層と衝突していることが確認できる場合、ボタンにはスターターのスタイルが適用されている可能性が高いと判断します。

• 通常のテキスト CTA が、rounded-full、9999px、または高さの半分以上の計算上の角丸など、カプセル形状を使用している
• アクションが、汎用的な角丸、標準のパディング、塗りつぶし、白いラベル、デフォルトのホバー／フォーカス処理からなる、変更されていないスターターライブラリのレシピを踏襲しており、意味のある階層や製品らしさがない

実際のチップ、タグ、フィルタートークン、セグメントコントロール、トグル、円形のアイコンのみのコントロールは許容されます。通常の CTA は、小さいからといってチップにはなりません。

デフォルトの判定：

可能性が高い — 汎用的な角丸 CTA／ピル型 CTA。形状と状態の処理が、変更されていないスターターパターンを踏襲しており、この製品のアクション階層を表現できていません。このパターンがここで確立され、機能している場合を除き、アクションシステムを再設計してください。

プライマリ、セカンダリ、破壊的、控えめなアクションを、ひとつのシステムとして修正してください。形状、タイポグラフィ、ボーダーまたは塗りつぶし、アイコンの扱い、フォーカス、ホバー、押下中、読み込み中、無効の各状態は、製品のビジュアルランゲージに基づいて選択してください。すべてのピル型ボタンを、同じ標準的な 8px の黒い四角形に置き換えないでください。

4. その他の確度の高い指摘

• フェイクのターミナル装飾、装飾的なきらめき、アニメーション付きグラデーションボーダー、定型的な紙吹雪、絵文字ナビゲーションは、製品の主題、状態、使用頻度、または確立されたブランドに合わない場合、可能性が高いと判断します。
• 裏付けのない統計バナーや、捏造された、または誤解を招くグラフは、主張の信頼性に関する欠陥です。見た目が生成されたものに見えるかどうかにかかわらず、QUALITY DEFECTS に報告してください。

見た目に依存する指摘は、レンダリング結果で確認してください。違反した正確な役割、反復、ミスマッチ、または信頼性に関するルールを明示してください。「フォントがダサい」「ボタンが退屈」は指摘事項ではありません。

フェーズ 4：文脈に依存するスロップを見つける

関連性のないページ上の役割にまたがって繰り返し使われている場合、またはリポジトリ内の根拠がない場合、以下を可能性が高いと判断します。それ以外の場合は、文脈上の兆候として評価してください。

レイアウトとコンポーネントに関する兆候

• 中央揃えのバッジまたはピル型要素 → 大きすぎる H1 → 2 つの CTA → 同じサイズの機能カード 3 枚
• コンテンツの種類にかかわらず、アイコン、見出し、本文を並べた均一な 3 列カード
• 順序のないコンテンツに使われる 01 / 02 / 03 の番号付きステップ
• 関連性のないアイデアを装飾的なタイルに平坦化する Bento レイアウト
• ネストされたカードや、内容の異なる要素に強制された同じ高さ
• 情報設計にかかわらず、同じ幅のフッター列 4 つ
• 曖昧な見出しがあり、製品を示す根拠がない、ビューポート全体を占めるヒーロー
• エディトリアルな印象を出すことだけを目的とした、汎用的なオフセット構成
• 3 つ以上の意味的な役割に無理に適用された、単一のカードコンポーネントまたはデータスキーマ
• ほぼすべての表面に適用された rounded-2xl、同一のボーダー、または同一のシャドウ
• あらゆる機能見出しの上に置かれた、角丸正方形のアイコンタイル
• 変更されていないデフォルトの shadcn またはスターターキットのスタイル

色と効果に関する兆候

• ヒーローまたは CTA を支配する、紫から青、インディゴからピンク、または同様のデフォルトグラデーション
• メイン見出しのグラデーションテキスト
• 汎用的なテクノロジー風の質感として使われるグリッドまたはドット背景
• 製品やブランドによる根拠のない、暖色系のアンバーとクリーム色、無難なエメラルド色、またはラベンダー色
• 意味上の役割がないのに競合するアクセントカラー
• グレイン、環境光のスポット、グロー、ガラス、ストライプ、装飾的な疑似要素
• ひとつの領域に重ねられた 3 つ以上の装飾効果
• 暗い背景上のコントラストが低い灰色のテキスト。コントラストが基準を満たさない場合は、別途、品質上の欠陥として報告してください

タイポグラフィの兆候

• 製品との相性ではなく、デフォルトで選ばれた Inter、Geist、Space Grotesk、または Instrument Serif
• 流行に乗った安易な組み合わせとして、Space Grotesk と Instrument Serif を併用
• 通常の文章に等幅フォントを使用
• 強調するだけの理由もなく、ビューポートを占有するヒーローの文字
• 装飾としてヒーロー内の単語一つだけにイタリックのセリフ体を適用
• あらゆるセクションで繰り返される全大文字のラベル
• 階層が平坦、または表示スタイルが競合しすぎている

よくあるフォントだからという理由だけで指摘しないでください。意図的な役割、適合性、階層が欠けている場合に指摘してください。

モーションの兆候

• 日常的な操作部品にバウンスや弾性のあるイージングを使用
• あらゆるセクションやリストに適用された、時間差のあるフェードイン
• 時間経過による説明が不要なコンテンツに読み込みアニメーションを使用
• 汎用的な画像のホバー時の拡大または回転
• 幅、高さ、パディング、マージンのアニメーション
• prefers-reduced-motion の欠落。品質上の欠陥として報告してください

画像とデータの兆候

• 汎用的な AI 製品画像として使われる抽象的な 3D の塊、球体、脳、またはニューラルネットワーク
• 汎用的な、ノートパソコンを囲むチームのストックフォト
• 製品の主題に合わない、滑らかで左右対称な AI イラスト
• 無関係な主張やルートで同じ画像を使い回す
• 装飾的なフレームの背後に実際の製品を隠すスクリーンショット
• もっともらしくないデータ、不適切なグラフの種類、軸や単位の欠落、判読しにくいラベル、アクセシブルでない色分け、または示された要点の欠落があるグラフ

フェーズ 5：収束度と適合性を測定する

個々の要素だけでなく、コードベース全体における判断の分布を監査します。

• ルートの構造を比較します。ランドマークの順序、ヒーローの構成、セクションの順序、コンポーネントツリー、レイアウトのプリミティブ、繰り返されるクラスの組み合わせを確認します。
• ページの類似性を判断する前に、共通のクロームを除外します。
• 意味的に異なるルート間で、構造が高い類似性を示す場合は指摘します。
• 個々のトークンだけでなく、モチーフの組み合わせの繰り返しを数えます。
• 無関係なコンテンツが、同じ icon + title + description やカードのスキーマに無理に当てはめられていないか確認します。
• すべてのサーフェスの役割で、同じ角丸、影、アクセント、タイポグラフィの処理が使われていないか確認します。
• アセットの使い回しと各ページの意味を比較します。
• 同じ役割のページ間では一貫性を保ち、異なる役割のページ間では適応を求めます。

ページの役割との適合性を明示的に判断します。

• マーケティングページには、具体的な価値提案と製品の根拠が必要です。
• 料金ページには、比較と意思決定の支援が必要です。
• ダッシュボードには、タスクの密度、状態、情報の階層が必要です。
• ドキュメントには、ナビゲーション、順序、読みやすい例が必要です。
• 設定には、明瞭さ、影響の説明、安全な操作が必要です。

ハードバン以外のデザイン候補はすべて、次の透明性の高いヒューリスティックで採点します。

• +2 3 つ以上の異なるコンテキストで繰り返されている
• +2 ページの目的、コンテンツの形状、または文書化されたブランドと矛盾している
• +2 レンダリングされたページで視覚的に大きく目立つ
• +1 ほかの汎用的なデフォルトが 2 つ以上同時に使われている
• +1 理解や操作の階層を損なっている
• -2 根拠によって裏付けられた、具体的な機能上またはブランド上の正当な理由がある

このスコアは指針として使い、科学的な正確さがあるかのように扱わないでください。

• 5+：確信度 HIGH。削除または再設計を推奨します
• 3–4：確信度 MEDIUM。欠けている正当化の説明を添え、強い推定として報告します
• ≤2：確信度 LOW。欠陥からは除外するか、観察事項としてのみ記載します

正確な基準が確認されたハードバンには、このスコアを適用しません。

フェーズ 6：コピーを監査する

マーケティングコピーと製品内の文言を、システムとして監査します。単独では問題のない部分文字列、引用、製品名、コード例、法的文言、必要な技術用語ではなく、その用法を指摘してください。

コピー一覧を作成する

抽出を始める前に、対象範囲となる画面、チャネル、フロー、ルート、ロケール、状態を定義します。利用できないものがあれば、網羅されているかのように示すのではなく、その旨を報告します。

マークアップ、コンポーネントの props、定数、ロケールファイル、CMS フィクスチャ、トースト、エラー、空の状態、読み込み状態、ダイアログ、フォーム、メール、通知から、ユーザー向け文字列を抽出します。

各文字列について、以下を記録します。

• 画面またはチャネル、フロー、任意のルート、ページの役割、コンポーネント、UI の状態
• ソースファイルと行番号
• 補間後の表示テキスト（取得できる場合）
• ロケール、メッセージ ID、補間変数、複数形または選択肢の分岐、該当する場合はフォールバック
• 該当する場合、アクセシブルネーム、代替テキスト、検証上の役割、その他の非表示の目的
• 一意のソース判断と、共有コンポーネントによって生成されるすべての表示インスタンス
• 重大な影響を伴うコピーや重要な主張については、実際のアクション、遷移先、システム状態、または主張の根拠。それ以外は N/A を使用

テスト、ログ、表示値のないローカライズキー、製品のコミュニケーションとして提示されていない引用文やコード例、意図的にテンプレートと明示されたものは対象外とします。実際のドキュメント本文は対象に含めます。共有ナビゲーションは用語監査には含めますが、ルート横断の収束数には含めません。

問題のあるコピーを厳密に見つける

正確な定義を満たす場合に限り、HARD BAN を使用します。表現の形だけでは根拠になりません。コピーのハードバンは必須の削除判定として扱い、AI が作成したことの証明とはみなしません。

1. ユーザー向けの仮コピー

完成した製品コピーとして公開されている Lorem ipsum、TODO、Feature 1、Your headline here、明示的に仮のもの、または架空だと確認された推薦文、その他の足場となる仮コピーを禁止します。根拠が不足している推薦文には UNVERIFIED の印を付け、証拠なしに架空と断定しないでください。デモ、テンプレート、ドキュメントの例であることが明確に示されている場合は許可します。

HARD BAN — ユーザー向けのプレースホルダーコピー。これは製品のコミュニケーションではなく、仮の文言です。削除し、検証済みの内容に置き換えるか、ブロックごと省略してください。

2. 内容のない説明やリズム表現

削除しても主張、指示、対象範囲、ナビゲーション、安心感、安全上の注意、アクセシビリティ上の目的、意図的な語り口、有意義な対比のいずれも損なわれない導入、つなぎ、マーケティング表現を禁止します。以下の空疎な用法が該当します。

• 「今日の目まぐるしく変化する世界では」、「さっそく見ていきましょう」、「ここがポイントです」
• 「X が重要なのではなく、Y が重要です」、「X するだけでなく、Y もします」
• 「X は不要。Y も不要。必要なのは Z だけ」、「X から Y へ」、または「高速。シンプル。強力。」のような短い三連表現

具体的な事実を伝える表現は禁止しないでください。「設定不要。クレジットカード不要。URL を貼り付けるだけです。」は具体的ですが、「摩擦なし。制限なし。成長するだけです。」は具体性がありません。

HARD BAN — 内容のないコピー。「[quote]」は情報を加えず、修辞的な表現に終始しています。削除し、最初の実質的な主張から始めてください。

3. 意味が完全に重複するコピー

同じ表示状態で、仕組み、詳細、含意、根拠、判断、次のアクションを加えずに同じ主張を繰り返すコピーを禁止します。レスポンシブ表示の代替、相互排他的な状態、アクセシビリティ専用の同等表現、長文ドキュメントにおける有意義な要約は対象外です。

HARD BAN — 意味の重複。「[quote]」は情報を加えずに、[earlier copy] を繰り返しています。削除するか、不足している詳細に置き換えてください。

4. 重大な影響を伴う曖昧なコピー

支払い、削除、公開、権限、アカウント、その他の重大な影響を伴うアクションで、唯一のラベルとして使われている Submit、OK、Confirm、Continue を禁止します。ユーザーが対象、結果、または復旧アクションを知る必要がある場合、メッセージ全体が「問題が発生しました」、「成功しました！」、「データがありません」だけで構成されるコピーも禁止します。

周囲のフローから結果が明確でリスクが低い場合、一般的な Back、Close、Done、Retry、Continue は許可します。

HARD BAN — 重大な影響を伴う曖昧なコピー。「[quote]」では、これから起こること、または直前に起きたことが分かりません。アクションと対象、結果、または安全な復旧方法を明示してください。

主張と状態の整合性を分けて評価する

AI が作成した証拠ではなく、品質上の欠陥として報告します。

• 捏造された、または未検証の統計、推薦文、ランキング、認証、ロゴ、顧客数
• 根拠のない比較、断定、安全性、プライバシー、信頼性、性能に関する主張
• システムが実際には把握していないエラーの原因
• システムが持っていない測定値を示す進捗テキスト
• 操作の完了が確認される前に表示される成功メッセージ
• 実際の製品の動作と矛盾する用語やアクションラベル

出典がリポジトリに存在しないという理由だけで、証拠を捏造と呼んではいけません。未検証と記し、出典の提示を求め、誤りが証明された場合、または根拠がないままの場合にのみ削除します。

強い推定に当たるものを見つける

リポジトリ内の証拠で不足している具体的な内容が補われない場合、次の項目を強い推定として扱います。

• 製品が何をするのか、誰を対象とするのか、なぜ重要なのかを明らかにできていない、ヒーローメッセージ全体
• 具体的なタスク、仕組み、制約、成果が示されない「価値を引き出す」「ワークフローを向上させる」「混乱を明瞭さに変える」「無制限に拡張する」などの抽象表現
• 世界クラス、一流、実戦で実証済み、革新的、インテリジェント、AI 搭載など、中身のない誇張表現
• 文脈から遷移先や結果が明確でない、汎用的な CTA テキスト
• 修辞疑問、使い古された対比、変化を強調する見出し、または互いに無関係なルートで繰り返される、名詞だけを入れ替えた機能説明
• 実際の機能を隠しながら、すべての機能に便益優先の定型を押しつけること
• 周囲のコピーに裏付けられていない、突然のくだけすぎた、かわいらしい、大げさな、または過度に技術的な語調
• 占めるスペースに見合う情報をほとんど追加していないが、完全な重複ではない要約

文脈上のシグナルは文脈に沿って扱う

個々の語彙の出現、ダッシュ、断片的な文、修辞疑問、短縮形、文頭の「そして」や「しかし」、受動態、専門用語、ユーモア、絵文字、要約、便益優先または機能優先の構成は、文脈上のシグナルとして扱います。

実際の不確実性、確率、適用範囲、機能、リスク、法的な但し書き、期間を伝えるヘッジ表現は維持します。削除するのは、回りくどい前置きに限ります。シームレス、堅牢、パワフル、最先端、革新的、活用する、高める、力を与える、引き出す、活用する、強化する、作り上げる、深く掘り下げる、織物、シナジーは、検索の手がかりとして扱い、自動的に欠陥とはみなしません。

コピーの収束度と具体性を測る

ルートやコンポーネント間のコピーを、次の観点で比較します。

• 完全一致および類似した表現
• 製品名詞、数値、名前をスロットに置き換えた後に繰り返される文の骨格
• 繰り返される見出しの定型、CTA の動詞、対比構造、断片文、三項列挙、ダッシュ、修辞疑問
• 繰り返し使われるセクション構成（導入ラベル → 命令形の見出し → 1 文の約束 → CTA）
• 用語の揺れ：同じドメインオブジェクトやアクションに対する複数の名称や動詞
• ダッシュボード、エラー、設定、破壊的な操作フローへの、共通のマーケティング口調の流入

同じ役割を持つページ間の一貫性は保ちます。料金、ドキュメント、オンボーディング、設定、製品 UI に同じセールス用の定型が現れていないか確認します。

次の 4 つのテストを使います。

1. **削除：**テキストを削除すると、意味のある情報や操作が失われますか？
2. **3 製品置き換え：**互いに無関係な 3 つの製品でも、そのまま使えますか？
3. **証拠：**重要な主張はそれぞれ、機能、制約、測定値、出典、または検証済みの成果に結びついていますか？
4. **状態：**テキストは、システムが把握していること、起きたこと、ユーザーができることと一致していますか？

重要な命題は、孤立した文ではなく、メッセージブロックとして評価します。行為者、アクション、ドメインオブジェクト、仕組み、制約、観測可能な結果のうち、十分な数の具体的な要素があるか確認します。すべてのラベルや文に、これらすべてを含める必要はありません。

声のトーン、ページの役割、UI の状態を判断する

製品ドキュメント、顧客の言葉、特に優れた既存の例から、声のトーンを判断します。フォーマルさ、親しみやすさ、率直さ、技術的な情報量、人称、短縮形の使用、大文字・小文字の使い方、句読点、推奨用語を記録します。一貫した声を保ちつつ、重要度の高い場面では、より落ち着いた正確なトーンにします。

コピーを用途に合わせます。

• マーケティング：対象者、提案内容、仕組み、根拠、次のアクション
• 価格設定：実際の違い、費用、制限、請求条件、意思決定のサポート
• ドキュメント：前提条件、成果、手順、正確な例
• ダッシュボードと設定：スローガンではなく、現在の状態、タスク、結果、保存状況
• オンボーディングとアカウントのフロー：次に役立つアクション、復旧方法、セキュリティ上の影響

意味のあるフローについて、状態マトリクスを作成します。初期状態、初回利用時の空状態、フィルター適用後に結果がない状態、権限が制限された状態、読み込み中、データがある状態、無効状態、エラー、成功、確認を含めます。原因は判明している場合にのみ記載します。破壊的な操作の対象と、元に戻せるかどうかを明記します。すべての空状態を「X はまだありません — 最初の X を作成しましょう」の形式に無理に当てはめないでください。

文脈に応じたコピーを評価する

• 無関係な3つ以上の文脈で繰り返されている：+2
• ページの役割や UI 状態ごとの役割と矛盾している：+2
• メッセージブロックのレベルで製品固有の内容になっていない：+2
• 他の汎用的な表現とともに、定型的な構文やリズムが繰り返されている：+1
• 確立された声のトーン、用語、またはアクションの明確さを損なっている：+1
• 文書化された声のトーン、機能、顧客の言葉、または同じ役割の文脈による正当な理由がある：-2

5+ は HIGH、3–4 は MEDIUM、≤2 は LOW とします。明確に禁止されている表現や完全性に関する不備には、このスコアを適用しません。

事実を捏造せずにコピーを修正する

• 埋め草と完全な重複を削除します。
• 抽象的な主張を、メッセージブロックに適した、確認済みの分野固有の名詞、ユーザーのアクション、仕組み、制約、または成果に置き換えます。
• 裏付けのない主張は範囲を狭めるか削除します。必要な事実が不足している場合、指標、機能、根拠を捏造せず、修正案に BLOCKED — CONTENT REQUIRED と記載します。
• 重要なアクションと対象を明記します。エラーについては、影響と復旧方法を示し、原因は判明しており、かつ有用な場合にのみ記載します。
• 空状態の種類を区別し、それぞれに必要な案内だけを記述します。
• 調整された不確実性、必要な技術用語、標準的なコントロール、意図された声のトーンを維持します。
• 周囲のコピーも確認し、局所的な書き換えによって用語やトーンにずれが生じないようにします。
• AI の誇大表現を、均一で簡潔かつぶっきらぼうな、見せかけのミニマルな標準トーンに置き換えることは避けます。

フェーズ 7：問題点と修正内容を報告する

編集する前に停止します。ユーザーへの影響度、発生頻度、確信度、修正コストに基づいて優先順位を付けた要約から始めます。対象を絞った作業では、範囲内の問題点をすべて報告します。代表例を対象とする作業や網羅的な作業では、繰り返し現れるソース上の判断をまとめ、レンダリングされた箇所ごとに同じ修正を重複して報告しないようにします。該当する場合は、次のセクションを使用します。

COPY MANIFEST COVERAGE
Scope: [surfaces, routes, channels, locales, states]
Unavailable: [anything not inspected]
Unique source decisions: [count]  Rendered instances: [count]
Baseline: [hard bans, unverified claims, convergence clusters]

HARD SLOP — REMOVE
H1. [route, file:line] — [pattern]
    Before: [exact original]
    After: [verified replacement, deletion, or BLOCKED — CONTENT REQUIRED]
    Evidence: [exact code plus rendered evidence]
    Why it fails: [specific diagnosis]
    Verdict: Remove it.

CONTEXTUAL SLOP
C1. [route, file:line] — [pattern, score, HIGH or MEDIUM confidence]
    Verdict: [STRONG PRESUMPTION, CONTEXTUAL SIGNAL, or CANDIDATE]
    Before: [exact original]
    After: [product-specific repair or BLOCKED — CONTENT REQUIRED]
    Evidence: [repetition, mismatch, co-occurrence, render or copy manifest]

COPY CONVERGENCE
CC1. [convergence type and normalized pattern or term, score, confidence]
     Instances: [routes, states, files, and exact excerpts]
     Impact: [how unrelated jobs were flattened or terminology drifted]
     Repair: [which source decisions change and which terminology stays]
     Why it fails: [unrelated jobs forced through one voice or template]

QUALITY DEFECTS
Q1. [route, file:line] — [accessibility, semantics, performance, claim, or state-integrity issue]
    Evidence: [code, behavior, source, or contradiction]
    Impact: [user, trust, task, or compliance consequence]
    Provenance: [verified, unverified, contradicted, or not applicable]
    Recommendation: [repair, provenance request, or blocked status]

DECISIONS TO PRESERVE
P1. [element] — [why it is intentional, specific, and effective]

作成者ではなく成果物を批評します。客観的な明らかな粗雑さは率直に指摘します。「このプレースホルダーが完成済みのコピーとして表示されています。削除してください」と書き、「見直しを検討してもよいかもしれません」とは書きません。視覚的なデフォルトについては、好みを事実として提示せず、レンダリングされた証拠と確信度を示します。

実行可能なソース上の判断ごとに、置き換え内容をリポジトリの証拠に基づいて示せる場合は、正確な修正前と修正後を提示します。コンテンツや製品の意図が欠けている場合は、憶測に基づく代案を生成せず、必要な判断を明示します。プレースホルダーではなく、実際の製品コピーと既存のトークンを使用します。書き換えた主張は、引用したリポジトリ内の証拠に基づかせます。UNVERIFIED と BLOCKED — CONTENT REQUIRED は報告専用のステータスとして扱い、ユーザー向けコピーには絶対に記載しません。レンダリングが可能な場合は、同じルート、ビューポート、状態、データ、アニメーション設定で比較します。

製品の根拠に裏付けられていない限り、フラットな黒、単一のアクセントカラー、8px の角丸、2 列のリスト、どこも一律に簡潔な文章、デフォルトのカジュアルな口調など、定番の置き換え案を使用しないでください。まず意図するデザインやコピーの役割を示し、それを実現する最小限の修正を提案します。

フェーズ 8：確認して適用する

ユーザーが実装を依頼した場合、または診断の後に続行を求めた場合にのみ、このフェーズに入ります。診断のみの場合は、優先順位付きの報告、検証上の制限、修正を適用する旨の任意の一文を返します。承認を求める段階を作り出してはいけません。

実装が対象範囲に含まれる場合は、提案するソース変更または優先度の高い最初の修正群を提示した後、報告専用項目とブロックされた項目を実行可能な件数から除外し、次のように尋ねます。

[X] 件の修正を適用する準備ができました。スキップするものはありますか？ スキップする修正 ID を返信するか、すべて適用する場合は「go」と入力してください。

承認を待ちます。承認された変更だけを適用します。無関係なコードと、DECISIONS TO PRESERVE に記録された意図的な判断は保持します。

フェーズ 9：検証する

編集後：

1. プロジェクトで必要なビルド、型チェック、リンター、テストを実行します。
2. 同じルート、ビューポート、状態、データを再レンダリングします。
3. 禁止対象のパターンが、名前を変えただけでなく実際に取り除かれたことを確認します。
4. 型の役割とボタンの状態が、一貫した体系を形成していることを確認します。
5. 階層、オーバーフロー、コントラスト、フォーカス、セマンティクス、動きの抑制を確認します。
6. ルートの比較を再実行し、異なる役割のページが考えなしに同じテンプレートを共有していないことを確認します。
7. ある定番表現が別の定番表現に置き換わっていないことを確認します。
8. コピーのマニフェストを再抽出し、すべての禁止対象の件数がゼロになったことを確認します。
9. コピーのクラスタリングを再実行し、用語の一貫性を保ちながら、異なる役割のページが明確に区別されていることを確認します。
10. 重要な主張がすべて、出典を示す、範囲を定める、限定する、UNVERIFIED と明記する、または削除する対応を取られていることを確認します。
11. 操作ラベル、補間、複数形、ローカライズ、オーバーフロー、意味のある UI 状態をすべて再テストします。
12. 主要な操作フローを声に出して読み、修正によって簡潔さ一辺倒の口調や、会話調を装った統一的な文体が押し付けられていないことを確認します。

強固な共通基盤とページ固有の構成が両立し、判断に製品の個性が表れ、明らかな粗雑さが残っていない場合にのみ、作業がクリーンになったと判断します。