create-ai-project 1.23.3 → 1.23.5

package/.claude/agents-ja/skill-reviewer.md

@@ -87,56 +87,20 @@ skill-optimizationの9つの編集原則に対して評価:
   "grade": "A|B|C",
   "summary": "1-2文の総合評価",
   "patternIssues": [
-    {
-      "pattern": "BP-XXX",
-      "severity": "P1|P2|P3",
-      "location": "セクション見出し",
-      "original": "引用テキスト",
-      "suggestedFix": "置換テキスト"
-    }
+    {"pattern": "BP-XXX", "severity": "P1|P2|P3", "location": "セクション見出し", "original": "引用テキスト", "suggestedFix": "置換テキスト"}
   ],
   "patternExceptions": [
-    {
-      "pattern": "BP-XXX",
-      "location": "セクション見出し",
-      "original": "引用テキスト",
-      "conditions": {
-        "singleStepDestruction": "true|false + エビデンス",
-        "callerCannotRecover": "true|false + エビデンス",
-        "operationalNotPolicy": "true|false + エビデンス",
-        "positiveFormBlursScope": "true|false + エビデンス"
-      }
-    }
+    {"pattern": "BP-XXX", "location": "セクション見出し", "original": "引用テキスト", "conditions": {"singleStepDestruction": "true|false + エビデンス", "callerCannotRecover": "true|false + エビデンス", "operationalNotPolicy": "true|false + エビデンス", "positiveFormBlursScope": "true|false + エビデンス"}}
   ],
   "principlesEvaluation": [
-    {
-      "principle": "1: コンテキスト効率",
-      "status": "pass|partial|fail",
-      "detail": "合格以外の場合の説明"
-    }
+    {"principle": "1: コンテキスト効率", "status": "pass|partial|fail", "detail": "合格以外の場合の説明"}
   ],
-  "progressiveDisclosure": {
-    "tier1": "pass|fail（description品質）",
-    "tier2": "pass|fail（本文構造）",
-    "tier3": "pass|fail（参照構成）",
-    "details": "問題がある場合の具体的な指摘"
-  },
+  "progressiveDisclosure": {"tier1": "pass|fail（description品質）", "tier2": "pass|fail（本文構造）", "tier3": "pass|fail（参照構成）", "details": "問題がある場合の具体的な指摘"},
   "crossSkillIssues": [
-    {
-      "overlappingSkill": "スキル名",
-      "description": "重複内容",
-      "recommendation": "参照に置換 or 重複排除"
-    }
+    {"overlappingSkill": "スキル名", "description": "重複内容", "recommendation": "参照に置換 or 重複排除"}
   ],
-  "balanceAssessment": {
-    "overOptimization": "none|minor|major",
-    "lostExpertise": "none|minor|major",
-    "clarityTradeOff": "none|minor|major",
-    "descriptionQuality": "pass|needs fix"
-  },
-  "actionItems": [
-    "優先度順の修正リスト（P1 → P2 → 原則）"
-  ]
+  "balanceAssessment": {"overOptimization": "none|minor|major", "lostExpertise": "none|minor|major", "clarityTradeOff": "none|minor|major", "descriptionQuality": "pass|needs fix"},
+  "actionItems": ["優先度順の修正リスト（P1 → P2 → 原則）"]
 }
 ```
 

package/.claude/agents-ja/solver.md

@@ -73,6 +73,10 @@ skills: project-context, technical-spec, coding-standards, implementation-approa
 | mitigation | 影響を軽減する対策 | 根本解決まで時間がかかる場合の暫定策 |
 | fundamental | 再発防止を含む抜本対策 | 同様の問題が繰り返し発生している場合 |
 
+**隣接ケースのカバレッジ**:
+- 確認済みの障害点が `bug-fix` / `regression` / `state-change` / `boundary-change` に関わる場合（デバッグフローには Change Category フィールドが無いため、障害点自体から判断する）、同一の経路・契約・永続状態・外部境界を共有するケースが同じ修正を必要とするか評価する
+- 同一クラスの欠陥を共有する隣接ケースは解決スコープに含める。除外するものは residualRisks にその理由を記録する
+
 **生成した解決策の検証**:
 - プロジェクトルールに該当指針があるか確認
 - 指針がない領域は、WebSearchでその領域の現在のベストプラクティスを調査し、解決策が標準的アプローチに沿っているか検証
@@ -116,24 +120,10 @@ skills: project-context, technical-spec, coding-standards, implementation-approa
   },
   "solutions": [
     {
-      "id": "S1",
-      "name": "解決策の名前",
-      "type": "direct|workaround|mitigation|fundamental",
-      "description": "解決策の詳細説明",
-      "implementation": {
-        "approach": "実装アプローチの説明",
-        "affectedFiles": ["変更が必要なファイル"],
-        "dependencies": ["影響を受ける依存関係"]
-      },
-      "tradeoffs": {
-        "cost": {"level": "low|medium|high", "details": "詳細"},
-        "risk": {"level": "low|medium|high", "details": "詳細"},
-        "scope": {"level": "low|medium|high", "details": "詳細"},
-        "maintainability": {"level": "low|medium|high", "details": "詳細"},
-        "certainty": {"level": "low|medium|high", "details": "詳細"}
-      },
-      "pros": ["メリット"],
-      "cons": ["デメリット"]
+      "id": "S1", "name": "解決策の名前", "type": "direct|workaround|mitigation|fundamental", "description": "解決策の詳細説明",
+      "implementation": {"approach": "実装アプローチの説明", "affectedFiles": ["変更が必要なファイル"], "dependencies": ["影響を受ける依存関係"]},
+      "tradeoffs": {"cost": {"level": "low|medium|high", "details": "詳細"}, "risk": {"level": "low|medium|high", "details": "詳細"}, "scope": {"level": "low|medium|high", "details": "詳細"}, "maintainability": {"level": "low|medium|high", "details": "詳細"}, "certainty": {"level": "low|medium|high", "details": "詳細"}},
+      "pros": ["メリット"], "cons": ["デメリット"]
     }
   ],
   "recommendation": {
@@ -144,12 +134,7 @@ skills: project-context, technical-spec, coding-standards, implementation-approa
   },
   "implementationPlan": {
     "steps": [
-      {
-        "order": 1,
-        "action": "具体的なアクション",
-        "verification": "このステップの検証方法",
-        "rollback": "問題発生時のロールバック手順"
-      }
+      {"order": 1, "action": "具体的なアクション", "verification": "このステップの検証方法", "rollback": "問題発生時のロールバック手順"}
     ],
     "criticalPoints": ["特に注意すべきポイント"]
   },

package/.claude/agents-ja/task-decomposer.md

@@ -65,6 +65,7 @@ implementation-approachスキルで決定された実装戦略パターンに基
 2. **計画書の分析と全体設計**
    - フェーズ構成の確認
    - タスクリストの抽出
+     - `[x]` で完了マーク済みかつコミット済みと注記されたタスク（例: prepare-implementation レシピが解消した Phase 0）はスキップする — その作業は既にコードベースに存在する。未消化（`[ ]`）のタスクのみタスクファイルを生成し、完了済みの作業を再生成・再実行しない
    - 依存関係の特定
    - **全体最適化の検討**
      - 共通処理の識別（冗長実装の防止）
@@ -101,6 +102,7 @@ implementation-approachスキルで決定された実装戦略パターンに基
    - `## Implementation Content`（タスク概要）
    - `## Target Files`
    - `## Investigation Targets`（executor が実装前に読んで理解すべきファイル）
+   - `## Change Category`（タスクがバグ修正・リグレッション・状態変更・境界変更の場合 — 下記「Change Category の分類」参照）
    - `## Implementation Steps (TDD: Red-Green-Refactor)`
    - `## Quality Assurance Mechanisms`（作業計画書ヘッダーから導出 — 下記「品質保証メカニズムの伝播」参照）
    - `## Operation Verification Methods`（作業計画書の Verification Strategy から導出）
@@ -221,6 +223,21 @@ implementation-approachスキルで決定された実装戦略パターンに基
 3. **カバー範囲未指定の場合は全タスクに記載**: メカニズムのカバー範囲が指定されていない場合（project-wide）、すべてのタスクに含める
 4. **該当なしの場合は省略**: タスクの Target Files に該当するメカニズムがなければ `## Quality Assurance Mechanisms` セクションを省略
 
+## Change Category の分類
+
+タスクが観測された振る舞いを修正する、または状態や境界の振る舞いを変える場合、executor と下流のレビュアーがタスクの意図を推測し直すのではなくフィールド値からスコープ限定の隣接ケース走査を実行できるよう、これを分類する:
+
+1. **作業計画書と Design Doc から分類する**。タスクは複数のカテゴリに該当しうる（例: 永続状態の境界を変えるリグレッション修正）。該当する値をすべて記録する:
+   - `bug-fix`: 観測された誤った振る舞いを修正する
+   - `regression`: 過去の変更が壊した振る舞いを復元する
+   - `state-change`: 状態の書き込み・遷移・永続化のされ方を変える
+   - `boundary-change`: 外部・パッケージ間・永続化の境界で、公開または利用される契約を変える
+2. **タスクの `Change Category` フィールドに**該当する値をすべてカンマ区切りで記入する（task-template 参照）。
+3. **隣接ケースを Investigation Targets に追加する**。該当する各カテゴリについて、変更と同一の経路・契約・永続状態・外部境界を共有するファイル（影響を受ける境界の両側のオーナーモジュールを含む）を追加し、executor が同一クラスの欠陥を走査できるようにする。該当する全カテゴリにわたって対象を統合する。
+4. **該当する場合のみ適用する**。純粋な追加・設定・スキャフォールディングのタスクは既定で `Change Category` フィールドを持たず、この伝播をスキップする。
+
+これは AC ごとの境界パス証明（AC の*内側*の境界パスを証明する）とは別物である。Change Category は、タスクの AC の*外側*にありながらその経路・契約・状態・境界を共有するケースの走査を駆動する。
+
 ## タスクファイルテンプレート
 
 詳細はdocumentation-criteriaスキルのタスクテンプレートを参照。
@@ -287,7 +304,7 @@ implementation-approachスキルで決定された実装戦略パターンに基
 ### 分解完了レポート
 
 ```markdown
-📋 タスク分解完了
+タスク分解完了
 
 計画書: [ファイル名]
 全体設計書: _overview-[plan-name].md
@@ -358,6 +375,7 @@ implementation-approachスキルで決定された実装戦略パターンに基
 - [ ] 実装効率と手戻り防止（共通処理の事前識別、影響範囲の明確化）
 - [ ] 全タスクに調査対象が指定されている（具体的なファイルパス、曖昧なカテゴリではない）
 - [ ] 主張を実装する各タスクに Proof Obligations を記録（主要な故障モード + 検証する境界）
+- [ ] bug-fix / regression / state-change / boundary-change のタスクに Change Category を設定し、隣接する経路/境界のオーナーを Investigation Targets に追加済み
 - [ ] 作業計画書ヘッダーの品質保証メカニズムを該当タスクに伝播済み
 
 ## タスク設計の原則

package/.claude/agents-ja/task-executor-frontend.md

@@ -116,7 +116,7 @@ package.json の `packageManager` フィールドに従って実行コマンド
 
 ## 責務・権限・境界
 
-**範囲内**: `docs/plans/tasks/` からタスクファイルを読み込み、タスクの「Metadata」に記載された依存成果物を確認、React 関数コンポーネントと React Testing Library テストを作成、テストはコンポーネントと共に配置（co-locate）、Red→Green→Refactor のTDDを適用、進捗チェックボックスを更新（タスクファイルは常時更新。作業計画書と全体設計書は存在する場合のみ更新 — 小規模単一タスクではタスクファイルのみ存在）、`Provides` に指定された調査成果物を作成。状態遷移: `[ ]` → `[🔄]` → `[x]`。
+**範囲内**: `docs/plans/tasks/` からタスクファイルを読み込み、タスクの「Metadata」に記載された依存成果物を確認、React 関数コンポーネントと React Testing Library テストを作成、テストはコンポーネントと共に配置（co-locate）、Red→Green→Refactor のTDDを適用、進捗チェックボックスを更新（タスクファイルは常時更新。作業計画書と全体設計書は存在する場合のみ更新 — 小規模単一タスクではタスクファイルのみ存在）、`Provides` に指定された調査成果物を作成。状態遷移: `[ ]` → `[x]`。
 
 **範囲外（常に）**: 全体品質チェック（品質保証工程に委譲）、コミット作成（品質チェック後に実施）、Design Doc を満たせない場合の強行（必ずエスカレーション）、クラスコンポーネント（モダン React では非推奨）。
 
@@ -183,6 +183,17 @@ task_file パスはオーケストレータが渡す入力。プロンプトで
 2. **既存実装調査**：同ドメイン・責務で類似コンポーネント・hook を検索
 3. **判定実行**：上記「必須判断基準」に従い継続・エスカレーション判定
 
+#### 隣接ケース走査（タスクファイルの `Change Category` フィールドが `bug-fix` / `regression` / `state-change` / `boundary-change` のいずれかに設定されている場合は必須）
+
+実装前確認の後、Binding Decision チェックの前に実行する。このステップはタスク分解が書き込んだフィールド値で発火する — フィールド値を読み、走査を適用するかの判断はそれを正本とする。
+
+1. Investigation Targets（分解時に隣接ファイルが既に追加されている）から、変更と同一の経路・契約・永続状態・外部境界を共有するケースを特定する — 変更に関連するフォールバック描画、stale な状態、リトライ、外部呼び出しなど。
+2. それぞれが、このタスクが修正するのと同一クラスの欠陥を抱えているか確認する。
+3. 各残余をスコープに応じて処理する:
+   - **Target Files スコープ内** → 残余をこのタスクの失敗するテストと実装に取り込む。
+   - **修正を要すると確認できたスコープ外の兄弟ケース** → `out_of_scope_file` エスカレーション（Target Files 外のファイルに触れる際の標準経路）を発行し、ユーザーが Target Files を拡張するか follow-up タスクに切り出すかを判断できるようにする。これにより、確認済みの隣接欠陥は明示的な判断に回される。
+   - **修正を要するか確認できない関連残余** → タスクファイルの Investigation Notes に記録し、code-reviewer の隣接ケースチェックが実装に対して検証できるようにする。
+
 #### Binding Decision チェック（タスクファイルに Binding Decisions セクションがある場合は必須）
 
 このチェックは実装前確認の後、TDDサイクルの前に実行される。タスクファイルに1行以上を持つ Binding Decisions セクションがある場合のみ適用される。
@@ -278,20 +289,8 @@ task_file パスはオーケストレータが渡す入力。プロンプトで
   "testsAdded": ["src/components/Button/Button.test.tsx"],
   "requiresTestReview": false,
   "newTestsPassed": true,
-  "progressUpdated": {
-    "taskFile": "完了項目5/8",
-    "workPlan": "該当箇所更新済み",
-    "designDoc": "進捗セクション更新済み or N/A"
-  },
-  "runnableCheck": {
-    "level": "L1: 単体テスト (React Testing Library) / L2: 統合テスト / L3: E2Eテスト",
-    "executed": true,
-    "command": "test -- Button.test.tsx",
-    "result": "passed / failed / skipped",
-    "substance": "substantive | non_substantive | null (非テスト系の検証)",
-    "substanceIssue": "substantive または非テスト系の場合は null。non_substantive の場合は原因と位置を記載",
-    "reason": "テスト実行理由・確認内容"
-  },
+  "progressUpdated": {"taskFile": "完了項目5/8", "workPlan": "該当箇所更新済み", "designDoc": "進捗セクション更新済み or N/A"},
+  "runnableCheck": {"level": "L1: 単体テスト (React Testing Library) / L2: 統合テスト / L3: E2Eテスト", "executed": true, "command": "test -- Button.test.tsx", "result": "passed / failed / skipped", "substance": "substantive | non_substantive | null (非テスト系の検証)", "substanceIssue": "substantive または非テスト系の場合は null。non_substantive の場合は原因と位置を記載", "reason": "テスト実行理由・確認内容"},
   "readyForQualityCheck": true,
   "nextActions": "品質チェック工程による全体品質検証"
 }
@@ -334,11 +333,7 @@ task_file パスはオーケストレータが渡す入力。プロンプトで
   "reason": "Out of scope file",
   "taskName": "[タスク名]",
   "escalation_type": "out_of_scope_file",
-  "details": {
-    "file_path": "[変更を試みたパス]",
-    "allowed_list": ["[Target Files / タスクファイル / 作業計画書 / Provides の和集合]"],
-    "modification_reason": "[なぜ変更を試みたか]"
-  },
+  "details": {"file_path": "[変更を試みたパス]", "allowed_list": ["[Target Files / タスクファイル / 作業計画書 / Provides の和集合]"], "modification_reason": "[なぜ変更を試みたか]"},
   "user_decision_required": true,
   "suggested_options": ["Target Files に追加してリトライ", "別タスクに分割", "アプローチを再検討"]
 }

package/.claude/agents-ja/task-executor.md

@@ -116,7 +116,7 @@ package.json の `packageManager` フィールドに従って実行コマンド
 
 ## 責務・権限・境界
 
-**範囲内**: `docs/plans/tasks/` からタスクファイルを読み込み、タスクの「Metadata」に記載された依存成果物を確認、実装とテストを作成、Red→Green→Refactor のTDDを適用、進捗チェックボックスを更新（タスクファイルは常時更新。作業計画書と全体設計書は存在する場合のみ更新 — 小規模単一タスクではタスクファイルのみ存在）、`Provides` に指定された調査成果物を作成。状態遷移: `[ ]` → `[🔄]` → `[x]`。
+**範囲内**: `docs/plans/tasks/` からタスクファイルを読み込み、タスクの「Metadata」に記載された依存成果物を確認、実装とテストを作成、Red→Green→Refactor のTDDを適用、進捗チェックボックスを更新（タスクファイルは常時更新。作業計画書と全体設計書は存在する場合のみ更新 — 小規模単一タスクではタスクファイルのみ存在）、`Provides` に指定された調査成果物を作成。状態遷移: `[ ]` → `[x]`。
 
 **範囲外（常に）**: 全体品質チェック（品質保証工程に委譲）、コミット作成（品質チェック後に実施）、Design Doc を満たせない場合の強行（必ずエスカレーション）。
 
@@ -183,6 +183,17 @@ task_file パスはオーケストレータが渡す入力。プロンプトで
 2. **既存実装調査**：同ドメイン・責務で類似機能を検索
 3. **判定実行**：上記「必須判断基準」に従い継続・エスカレーション判定
 
+#### 隣接ケース走査（タスクファイルの `Change Category` フィールドが `bug-fix` / `regression` / `state-change` / `boundary-change` のいずれかに設定されている場合は必須）
+
+実装前確認の後、Binding Decision チェックの前に実行する。このステップはタスク分解が書き込んだフィールド値で発火する — フィールド値を読み、走査を適用するかの判断はそれを正本とする。
+
+1. Investigation Targets（分解時に隣接ファイルが既に追加されている）から、変更と同一の経路・契約・永続状態・外部境界を共有するケースを特定する — 変更に関連するフォールバックの振る舞い、stale な状態、リトライ、外部呼び出しなど。
+2. それぞれが、このタスクが修正するのと同一クラスの欠陥を抱えているか確認する。
+3. 各残余をスコープに応じて処理する:
+   - **Target Files スコープ内** → 残余をこのタスクの失敗するテストと実装に取り込む。
+   - **修正を要すると確認できたスコープ外の兄弟ケース** → `out_of_scope_file` エスカレーション（Target Files 外のファイルに触れる際の標準経路）を発行し、ユーザーが Target Files を拡張するか follow-up タスクに切り出すかを判断できるようにする。これにより、確認済みの隣接欠陥は明示的な判断に回される。
+   - **修正を要するか確認できない関連残余** → タスクファイルの Investigation Notes に記録し、code-reviewer の隣接ケースチェックが実装に対して検証できるようにする。
+
 #### Binding Decision チェック（タスクファイルに Binding Decisions セクションがある場合は必須）
 
 このチェックは実装前確認の後、TDDサイクルの前に実行される。タスクファイルに1行以上を持つ Binding Decisions セクションがある場合のみ適用される。
@@ -281,20 +292,8 @@ task_file パスはオーケストレータが渡す入力。プロンプトで
   "testsAdded": ["作成したテストファイルパス"],
   "requiresTestReview": true,
   "newTestsPassed": true,
-  "progressUpdated": {
-    "taskFile": "完了項目5/8",
-    "workPlan": "該当箇所更新済み",
-    "designDoc": "進捗セクション更新済み or N/A"
-  },
-  "runnableCheck": {
-    "level": "L1: 単体テスト / L2: 統合テスト / L3: E2Eテスト",
-    "executed": true,
-    "command": "実行したテストコマンド",
-    "result": "passed / failed / skipped",
-    "substance": "substantive | non_substantive | null (非テスト系の検証)",
-    "substanceIssue": "substantive または非テスト系の場合は null。non_substantive の場合は原因と位置を記載",
-    "reason": "テスト実行理由・確認内容"
-  },
+  "progressUpdated": {"taskFile": "完了項目5/8", "workPlan": "該当箇所更新済み", "designDoc": "進捗セクション更新済み or N/A"},
+  "runnableCheck": {"level": "L1: 単体テスト / L2: 統合テスト / L3: E2Eテスト", "executed": true, "command": "実行したテストコマンド", "result": "passed / failed / skipped", "substance": "substantive | non_substantive | null (非テスト系の検証)", "substanceIssue": "substantive または非テスト系の場合は null。non_substantive の場合は原因と位置を記載", "reason": "テスト実行理由・確認内容"},
   "readyForQualityCheck": true,
   "nextActions": "品質チェック工程による全体品質検証"
 }
@@ -337,11 +336,7 @@ task_file パスはオーケストレータが渡す入力。プロンプトで
   "reason": "Out of scope file",
   "taskName": "[タスク名]",
   "escalation_type": "out_of_scope_file",
-  "details": {
-    "file_path": "[変更を試みたパス]",
-    "allowed_list": ["[Target Files / タスクファイル / 作業計画書 / Provides の和集合]"],
-    "modification_reason": "[なぜ変更を試みたか]"
-  },
+  "details": {"file_path": "[変更を試みたパス]", "allowed_list": ["[Target Files / タスクファイル / 作業計画書 / Provides の和集合]"], "modification_reason": "[なぜ変更を試みたか]"},
   "user_decision_required": true,
   "suggested_options": ["Target Files に追加してリトライ", "別タスクに分割", "アプローチを再検討"]
 }

package/.claude/agents-ja/ui-analyzer.md

@@ -165,142 +165,43 @@ skills: frontend-typescript-rules, frontend-technical-spec, project-context
 
 ```json
 {
-  "analysisScope": {
-    "filesAnalyzed": ["path/to/component.tsx"],
-    "stylesAnalyzed": ["path/to/styles.module.css"],
-    "uiConventions": {
-      "componentExtension": ".tsx",
-      "styleStrategy": "css-modules|vanilla-css|css-in-js|utility-classes",
-      "storybook": true,
-      "testRunner": "vitest|jest|other"
-    }
-  },
+  "analysisScope": {"filesAnalyzed": ["path/to/component.tsx"], "stylesAnalyzed": ["path/to/styles.module.css"], "uiConventions": {"componentExtension": ".tsx", "styleStrategy": "css-modules|vanilla-css|css-in-js|utility-classes", "storybook": true, "testRunner": "vitest|jest|other"}},
   "externalResources": {
     "status": "fetched|partial|not_recorded",
-    "designOrigin": {
-      "fetch_status": "fetched|mcp_unavailable|skipped|not_applicable",
-      "accessMethod": "MCP name | URL | file path | existing-implementation-only",
-      "fetched_summary": "brief description of fetched content (e.g., screen names, frame ids, token snapshot)"
-    },
-    "designSystem": {
-      "fetch_status": "fetched|mcp_unavailable|skipped|not_applicable",
-      "accessMethod": "...",
-      "fetched_summary": "components catalogued, tokens captured, anti-pattern identifiers"
-    },
-    "guidelines": {
-      "fetch_status": "fetched|skipped|not_applicable",
-      "accessMethod": "...",
-      "fetched_summary": "rule categories captured (CSS, accessibility, i18n, etc.)"
-    },
-    "visualVerification": {
-      "fetch_status": "available|mcp_unavailable|not_applicable",
-      "accessMethod": "...",
-      "notes": "how rendered output is verified during implementation"
-    }
+    "designOrigin": {"fetch_status": "fetched|mcp_unavailable|skipped|not_applicable", "accessMethod": "MCP name | URL | file path | existing-implementation-only", "fetched_summary": "brief description of fetched content (e.g., screen names, frame ids, token snapshot)"},
+    "designSystem": {"fetch_status": "fetched|mcp_unavailable|skipped|not_applicable", "accessMethod": "...", "fetched_summary": "components catalogued, tokens captured, anti-pattern identifiers"},
+    "guidelines": {"fetch_status": "fetched|skipped|not_applicable", "accessMethod": "...", "fetched_summary": "rule categories captured (CSS, accessibility, i18n, etc.)"},
+    "visualVerification": {"fetch_status": "available|mcp_unavailable|not_applicable", "accessMethod": "...", "notes": "how rendered output is verified during implementation"}
   },
   "componentStructure": [
-    {
-      "name": "ComponentName",
-      "filePath": "path/to/file:lineNumber",
-      "propsInterface": "name and brief shape",
-      "topLevelElement": "tag or component name",
-      "domOrder": ["child1", "child2", "child3"],
-      "conditionalBranches": [
-        {"predicate": "condition expression", "renderedSubtree": "brief description"}
-      ],
-      "callSites": ["path/to/consumer:line"]
-    }
+    {"name": "ComponentName", "filePath": "path/to/file:lineNumber", "propsInterface": "name and brief shape", "topLevelElement": "tag or component name", "domOrder": ["child1", "child2", "child3"], "conditionalBranches": [{"predicate": "condition expression", "renderedSubtree": "brief description"}], "callSites": ["path/to/consumer:line"]}
   ],
   "propsPatterns": [
-    {
-      "component": "ComponentName",
-      "callSite": "path/to/file:line",
-      "props": {"variant": "primary", "size": "md"},
-      "computedProps": ["onClick (useCallback)"],
-      "groupKey": "primary-md"
-    }
+    {"component": "ComponentName", "callSite": "path/to/file:line", "props": {"variant": "primary", "size": "md"}, "computedProps": ["onClick (useCallback)"], "groupKey": "primary-md"}
   ],
   "cssLayout": [
-    {
-      "filePath": "path/to/styles.module.css",
-      "classNamingConvention": "camelCase|kebab-case|BEM",
-      "baseClass": "root",
-      "layouts": [
-        {
-          "selector": ".className",
-          "display": "flex|grid|block",
-          "direction": "row|column|grid-template",
-          "gap": "8px|none",
-          "wrap": "wrap|nowrap|absent",
-          "logicalProperties": true,
-          "stateSelectors": ["[data-state=active]", "[aria-selected=true]"]
-        }
-      ],
-      "responsiveBreakpoints": ["768px", "1024px"]
-    }
+    {"filePath": "path/to/styles.module.css", "classNamingConvention": "camelCase|kebab-case|BEM", "baseClass": "root", "layouts": [{"selector": ".className", "display": "flex|grid|block", "direction": "row|column|grid-template", "gap": "8px|none", "wrap": "wrap|nowrap|absent", "logicalProperties": true, "stateSelectors": ["[data-state=active]", "[aria-selected=true]"]}], "responsiveBreakpoints": ["768px", "1024px"]}
   ],
   "stateDisplay": [
-    {
-      "component": "ComponentName",
-      "states": [
-        {"name": "loading|empty|partial|error|ready|disabled", "trigger": "what causes this state", "renders": "brief description"}
-      ],
-      "unsupportedStates": ["states the component does not currently express"]
-    }
+    {"component": "ComponentName", "states": [{"name": "loading|empty|partial|error|ready|disabled", "trigger": "what causes this state", "renders": "brief description"}], "unsupportedStates": ["states the component does not currently express"]}
   ],
   "displayConditions": [
-    {
-      "component": "ComponentName",
-      "condition": "feature_flag|role|route|region|tenant|page_context",
-      "predicateLocation": "path/to/file:line",
-      "predicate": "expression",
-      "gatedSubtree": "brief description"
-    }
+    {"component": "ComponentName", "condition": "feature_flag|role|route|region|tenant|page_context", "predicateLocation": "path/to/file:line", "predicate": "expression", "gatedSubtree": "brief description"}
   ],
-  "i18n": {
-    "format": "csv|json|code-catalog|other",
-    "structuralConventions": {"csvColumns": 2, "trailingComma": false, "jsonNestingDepth": 1},
-    "keyNamingConvention": "pattern with examples",
-    "locales": ["ja-JP", "en-US"],
-    "localeGaps": ["keys present in one locale only"],
-    "generatedTypings": {"command": "generator command", "outputPath": "path/to/output"}
-  },
+  "i18n": {"format": "csv|json|code-catalog|other", "structuralConventions": {"csvColumns": 2, "trailingComma": false, "jsonNestingDepth": 1}, "keyNamingConvention": "pattern with examples", "locales": ["ja-JP", "en-US"], "localeGaps": ["keys present in one locale only"], "generatedTypings": {"command": "generator command", "outputPath": "path/to/output"}},
   "accessibility": [
-    {
-      "component": "ComponentName",
-      "ariaAttributes": ["role=button", "aria-label fed by prop accessibleName"],
-      "keyboardHandling": "Enter and Space mapped to onClick",
-      "focusStyling": "focus-visible outline",
-      "testCoverage": "axe checks present|absent"
-    }
+    {"component": "ComponentName", "ariaAttributes": ["role=button", "aria-label fed by prop accessibleName"], "keyboardHandling": "Enter and Space mapped to onClick", "focusStyling": "focus-visible outline", "testCoverage": "axe checks present|absent"}
   ],
   "generatedArtifacts": [
-    {
-      "kind": "css-module-typings|message-catalog-typings|route-typings|other",
-      "command": "generator command",
-      "trigger": "on *.module.css change|manual|other",
-      "consumers": ["typecheck", "test", "build", "runtime"]
-    }
+    {"kind": "css-module-typings|message-catalog-typings|route-typings|other", "command": "generator command", "trigger": "on *.module.css change|manual|other", "consumers": ["typecheck", "test", "build", "runtime"]}
   ],
   "focusAreas": [
-    {
-      "fact_id": "src/components/Card/Card.tsx:Card",
-      "area": "Brief UI area name",
-      "evidence": "componentStructure[name=Card] | cssLayout[selector=.root] | propsPatterns[groupKey=...] | externalResources.designOrigin",
-      "factsToAddress": "Concrete UI facts the designer or implementer must respect",
-      "risk": "What inconsistency results if these facts are omitted"
-    }
+    {"fact_id": "src/components/Card/Card.tsx:Card", "area": "Brief UI area name", "evidence": "componentStructure[name=Card] | cssLayout[selector=.root] | propsPatterns[groupKey=...] | externalResources.designOrigin", "factsToAddress": "Concrete UI facts the designer or implementer must respect", "risk": "What inconsistency results if these facts are omitted"}
   ],
   "candidateWriteSet": [
-    {
-      "path": "src/components/Card/Card.tsx",
-      "reasonRef": "focusAreas[fact_id=src/components/Card/Card.tsx:Card]",
-      "confidence": "high|medium|low"
-    }
+    {"path": "src/components/Card/Card.tsx", "reasonRef": "focusAreas[fact_id=src/components/Card/Card.tsx:Card]", "confidence": "high|medium|low"}
   ],
-  "limitations": [
-    "Areas the analysis could not reach with confidence"
-  ]
+  "limitations": ["Areas the analysis could not reach with confidence"]
 }
 ```
 

package/.claude/agents-ja/verifier.md

@@ -61,7 +61,8 @@ skills: project-context, technical-spec, coding-standards
 
 1. **未トレースパス**: 症状が到達しうるのに調査でトレースされていないコードパスはないか（例: エラーハンドリング分岐、非同期フォーク、フォールバックパス）
 2. **未チェックノード**: トレース済みパス上でチェックされていないノードはないか
-3. **追加の障害点**: 未トレースパスや未チェックノードから新たな障害が見つかった場合は記録する
+3. **隣接ケース**: 調査が `bug-fix` / `regression` / `state-change` / `boundary-change` に関わる場合（デバッグフローには Change Category フィールドが無いため、調査自体から判断する）、同一の経路・契約・永続状態・外部境界を共有し同じ障害を抱えうるケースはないか。妥当な隣接ケースをすべてトレースするか、トレースしないものは明示的に正当化する
+4. **追加の障害点**: 未トレースパス・未チェックノード・隣接ケースから新たな障害が見つかった場合は記録する
 
 目的は、調査のパスカバレッジが十分であるかを検証すること。
 
@@ -115,78 +116,33 @@ skills: project-context, technical-spec, coding-standards
     "identifiedGaps": ["未トレースパスや未チェックノード"]
   },
   "triangulationSupplements": [
-    {
-      "source": "追加で調査した情報源",
-      "findings": "発見した内容",
-      "impactOnFailurePoints": "既存の障害点への影響"
-    }
+    {"source": "追加で調査した情報源", "findings": "発見した内容", "impactOnFailurePoints": "既存の障害点への影響"}
   ],
   "externalResearch": [
-    {
-      "query": "検索したクエリ",
-      "source": "情報源",
-      "findings": "発見した関連情報",
-      "impactOnFailurePoints": "障害点への影響"
-    }
+    {"query": "検索したクエリ", "source": "情報源", "findings": "発見した関連情報", "impactOnFailurePoints": "障害点への影響"}
   ],
   "coverageCheck": {
     "missingPaths": ["調査入力でトレースされていないパス"],
     "uncheckedNodes": ["トレース済みパス上の未チェックノード"],
     "additionalFailurePoints": [
-      {
-        "id": "AFP1",
-        "nodeId": "ノード参照",
-        "symptomId": "症状参照",
-        "description": "新たに発見された障害",
-        "checkStatus": "supported|weakened|blocked|not_reached",
-        "evidence": [
-          {"type": "supporting", "detail": "証拠の詳細", "source": "file:line"}
-        ]
-      }
+      {"id": "AFP1", "nodeId": "ノード参照", "symptomId": "症状参照", "description": "新たに発見された障害", "checkStatus": "supported|weakened|blocked|not_reached", "evidence": [{"type": "supporting", "detail": "証拠の詳細", "source": "file:line"}]}
     ]
   },
   "devilsAdvocateFindings": [
-    {
-      "targetFailurePoint": "FP1",
-      "alternativeExplanation": "正常な動作である可能性は？",
-      "hiddenAssumptions": ["暗黙の前提"],
-      "potentialCounterEvidence": ["見落とされている可能性のある反証"]
-    }
+    {"targetFailurePoint": "FP1", "alternativeExplanation": "正常な動作である可能性は？", "hiddenAssumptions": ["暗黙の前提"], "potentialCounterEvidence": ["見落とされている可能性のある反証"]}
   ],
   "failurePointEvaluation": [
-    {
-      "failurePointId": "FP1またはAFP1",
-      "description": "障害点の記述",
-      "originalCheckStatus": "調査入力のcheckStatus（検証段階で発見されたAFPはnull）",
-      "finalStatus": "supported|weakened|blocked|not_reached",
-      "statusChangeReason": "ステータスが変更された理由（変更があった場合）",
-      "remainingUncertainty": ["残る不確実性"]
-    }
+    {"failurePointId": "FP1またはAFP1", "description": "障害点の記述", "originalCheckStatus": "調査入力のcheckStatus（検証段階で発見されたAFPはnull）", "finalStatus": "supported|weakened|blocked|not_reached", "statusChangeReason": "ステータスが変更された理由（変更があった場合）", "remainingUncertainty": ["残る不確実性"]}
   ],
   "conclusion": {
     "confirmedFailurePoints": [
-      {
-        "failurePointId": "FP1",
-        "description": "障害の内容",
-        "location": "file:line",
-        "symptomId": "S1",
-        "symptomExplained": "この障害が観察された症状にどうつながるか",
-        "causeCategory": "typo|logic_error|missing_constraint|design_gap|external_factor",
-        "finalStatus": "supported|weakened",
-        "causalChain": ["現象", "→ 直接原因", "→ 根本原因"],
-        "impactScope": ["影響を受けるファイルパス"],
-        "recurrenceRisk": "low|medium|high"
-      }
+      {"failurePointId": "FP1", "description": "障害の内容", "location": "file:line", "symptomId": "S1", "symptomExplained": "この障害が観察された症状にどうつながるか", "causeCategory": "typo|logic_error|missing_constraint|design_gap|external_factor", "finalStatus": "supported|weakened", "causalChain": ["現象", "→ 直接原因", "→ 根本原因"], "impactScope": ["影響を受けるファイルパス"], "recurrenceRisk": "low|medium|high"}
     ],
     "refutedFailurePoints": [
       {"failurePointId": "FP2", "reason": "反証された理由"}
     ],
     "failurePointRelationships": [
-      {
-        "points": ["FP1", "FP3"],
-        "relationship": "independent|dependent|same_chain",
-        "detail": "障害点間の関係の説明"
-      }
+      {"points": ["FP1", "FP3"], "relationship": "independent|dependent|same_chain", "detail": "障害点間の関係の説明"}
     ],
     "coverageAssessment": "sufficient|partial|insufficient",
     "unresolvedSymptoms": ["確認された障害点で完全に説明できない症状"],

package/.claude/agents-ja/work-planner.md

@@ -55,7 +55,7 @@ fixture-e2e gap:
     AND e2eAbsenceReason.fixtureE2eが伝達されていない
     AND Design DocまたはUI Specにユーザー向けマルチステップジャーニーが含まれる
   THEN 作業計画書ヘッダーに追記:
-    ⚠ fixture-e2e Gap: この機能にはユーザー向けマルチステップジャーニーが含まれますが、
+    fixture-e2e Gap: この機能にはユーザー向けマルチステップジャーニーが含まれますが、
     fixture-e2eスケルトンが提供されていません。UI実装フェーズの前に、受入テスト生成
     へ差し戻して fixture-e2e 候補を評価する。
     検出されたジャーニー: [ジャーニーの説明とAC参照のリスト]
@@ -66,7 +66,7 @@ service-integration-e2e gap:
     AND Design Docがジャーニーに実サービス間検証（複数サービスをまたぐデータ永続化、
         トランザクション整合性、外部サービスコントラクト）を要求する
   THEN 作業計画書ヘッダーに追記:
-    ⚠ service-integration-e2e Gap: この機能はサービス境界をまたぎ、正しさが
+    service-integration-e2e Gap: この機能はサービス境界をまたぎ、正しさが
     実サービス間挙動に依存しますが、service-integration-e2eスケルトンが
     提供されていません。
     検出された境界: [境界の記述とAC参照のリスト]
@@ -157,8 +157,6 @@ ADRが入力に含まれる場合、またはDesign Docが「Prerequisite ADRs
 - **`scale: medium` / `scale: large`**: documentation-criteria スキルの **plan-template** に従って作業計画書を記述。フェーズ構成図とタスク依存関係図（mermaid）を含める。
 - **`scale: small`**: documentation-criteria スキルの **task-template** に従って単一タスクファイルを出力（後述「scale 別の出力モード」を参照）。フェーズ構成図・タスク依存関係図はスキップ。タスクファイルの `## Implementation Steps` セクションが実行を駆動する。
 
-`scale: medium` / `scale: large` の場合、計画書ヘッダーには `Implementation Readiness: pending` の行を必ず含める。マーカーの契約: 値は `pending`（初期。本エージェントが設定）、`ready`（検証完了、残存ギャップなし）、`escalated`（検証完了、残存ギャップあり）の3つのいずれか。`pending` から先へマーカーを昇格させるプロデューサと、実行前にマーカーを読むコンシューマは、本エージェントの外側で扱われる外部オーケストレーションの関心事である。
-
 ## Input Parameters
 
 - **mode**: `create`（デフォルト）| `update`
@@ -362,7 +360,6 @@ Design Docの技術的依存関係と実装アプローチに基づいてフェ
   - [ ] 各行の `Axis` 値が `placement` | `dependency_direction` | `contract_schema` | `data_flow` | `persistence` のちょうど1つである
   - [ ] 各行の `Source Section` が、ADR内の決定の実際の所在に一致する `Decision` または `Implementation Guidance` に設定されている
   - [ ] 全行が少なくとも1つのカバータスクにマッピングされている
-- [ ] 計画書ヘッダーに `Implementation Readiness: pending` を含める（medium / large のみ）
 - [ ] Design Docから検証戦略を抽出し計画書ヘッダーに記載
 - [ ] 計画書ヘッダーに証明戦略を記載（証明義務の出所 + タスクごとの伝播ルール）
 - [ ] 計画書ヘッダーにレビュースコープを記録（ベースブランチ / diff範囲 / 変更ファイル範囲）