create-ai-project 1.23.4 → 1.23.5

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

@@ -119,74 +119,21 @@ skills: project-context, technical-spec, coding-standards
 
 ```json
 {
-  "problemSummary": {
-    "phenomenon": "観察された現象の客観的記述",
-    "context": "発生条件、環境、タイミング",
-    "scope": "影響範囲"
-  },
+  "problemSummary": {"phenomenon": "観察された現象の客観的記述", "context": "発生条件、環境、タイミング", "scope": "影響範囲"},
   "investigationSources": [
-    {
-      "type": "code|history|dependency|config|document|external",
-      "location": "調査した場所",
-      "findings": "発見した事実（解釈を含めない）"
-    }
+    {"type": "code|history|dependency|config|document|external", "location": "調査した場所", "findings": "発見した事実（解釈を含めない）"}
   ],
   "externalResearch": [
-    {
-      "query": "検索したクエリ",
-      "source": "情報源",
-      "findings": "発見した関連情報",
-      "relevance": "この問題との関連性"
-    }
+    {"query": "検索したクエリ", "source": "情報源", "findings": "発見した関連情報", "relevance": "この問題との関連性"}
   ],
   "pathMap": [
-    {
-      "symptomId": "S1",
-      "symptom": "観察された症状の記述",
-      "trigger": "この症状を引き起こすトリガー",
-      "paths": [
-        {
-          "pathId": "S1-P1",
-          "description": "パスの説明（例: メインのデータ取得パス）",
-          "nodes": [
-            {
-              "nodeId": "S1-P1-N1",
-              "location": "file:line",
-              "description": "このノードが行うこと"
-            }
-          ]
-        }
-      ]
-    }
+    {"symptomId": "S1", "symptom": "観察された症状の記述", "trigger": "この症状を引き起こすトリガー", "paths": [{"pathId": "S1-P1", "description": "パスの説明（例: メインのデータ取得パス）", "nodes": [{"nodeId": "S1-P1-N1", "location": "file:line", "description": "このノードが行うこと"}]}]}
   ],
   "failurePoints": [
-    {
-      "id": "FP1",
-      "nodeId": "S1-P1-N1",
-      "symptomId": "S1",
-      "description": "障害の内容",
-      "causeCategory": "typo|logic_error|missing_constraint|design_gap|external_factor",
-      "location": "file:line",
-      "upstreamDependency": "このノードが依存しているもの",
-      "symptomExplained": "この障害が観察された症状にどうつながるか",
-      "causalChain": ["観察された障害", "→ 直接原因", "→ 根本原因（停止条件）"],
-      "checkStatus": "supported|weakened|blocked|not_reached",
-      "evidence": [
-        {"type": "supporting|contradicting", "detail": "証拠の詳細", "source": "情報源の場所", "strength": "direct|indirect|circumstantial"}
-      ],
-      "comparisonAnalysis": {
-        "normalImplementation": "正常動作する実装のパス（見つからない場合はnull）",
-        "keyDifferences": ["差分"]
-      }
-    }
+    {"id": "FP1", "nodeId": "S1-P1-N1", "symptomId": "S1", "description": "障害の内容", "causeCategory": "typo|logic_error|missing_constraint|design_gap|external_factor", "location": "file:line", "upstreamDependency": "このノードが依存しているもの", "symptomExplained": "この障害が観察された症状にどうつながるか", "causalChain": ["観察された障害", "→ 直接原因", "→ 根本原因（停止条件）"], "checkStatus": "supported|weakened|blocked|not_reached", "evidence": [{"type": "supporting|contradicting", "detail": "証拠の詳細", "source": "情報源の場所", "strength": "direct|indirect|circumstantial"}], "comparisonAnalysis": {"normalImplementation": "正常動作する実装のパス（見つからない場合はnull）", "keyDifferences": ["差分"]}}
   ],
   "impactAnalysis": [
-    {
-      "failurePointId": "FP1",
-      "impactScope": ["影響を受けるファイルパス"],
-      "recurrenceRisk": "low|medium|high",
-      "riskRationale": "リスク判定の根拠"
-    }
+    {"failurePointId": "FP1", "impactScope": ["影響を受けるファイルパス"], "recurrenceRisk": "low|medium|high", "riskRationale": "リスク判定の根拠"}
   ],
   "unexploredAreas": [
     {"area": "未探索領域", "reason": "調査できなかった理由", "potentialRelevance": "関連性"}

package/.claude/agents-ja/quality-fixer-frontend.md

@@ -199,11 +199,7 @@ package.json からフロントエンドビルドコマンドを自動検出し
 全レスポンスは `status` を共有し、`task_file` 提供時には `taskFileMechanisms` オブジェクトを含める:
 
 ```json
-"taskFileMechanisms": {
-  "provided": true,
-  "executed": ["mechanism names that were found and executed"],
-  "skipped": [{"mechanism": "mechanism name", "reason": "tool not found | config not found | not executable"}]
-}
+"taskFileMechanisms": {"provided": true, "executed": ["mechanism names that were found and executed"], "skipped": [{"mechanism": "mechanism name", "reason": "tool not found | config not found | not executable"}]}
 ```
 `task_file` が指定されなかった場合は `"provided": false` とし、`executed`/`skipped` は省略。
 

package/.claude/agents-ja/quality-fixer.md

@@ -163,11 +163,7 @@ coding-standardsおよびtypescript-testingスキルに従って修正を適用
 全レスポンスは `status` を共有し、`task_file` 提供時には `taskFileMechanisms` オブジェクトを含める:
 
 ```json
-"taskFileMechanisms": {
-  "provided": true,
-  "executed": ["mechanism names that were found and executed"],
-  "skipped": [{"mechanism": "mechanism name", "reason": "tool not found | config not found | not executable"}]
-}
+"taskFileMechanisms": {"provided": true, "executed": ["mechanism names that were found and executed"], "skipped": [{"mechanism": "mechanism name", "reason": "tool not found | config not found | not executable"}]}
 ```
 `task_file` が指定されなかった場合は `"provided": false` とし、`executed`/`skipped` は省略。
 

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

@@ -116,23 +116,12 @@ ADR作成条件の詳細はdocumentation-criteriaスキルに準拠。
   "fileCount": 3,
   "adrRequired": true,
   "adrReason": "該当する条件、または不要な場合はnull",
-  "technicalConsiderations": {
-    "constraints": ["リスト"],
-    "risks": ["リスト"],
-    "dependencies": ["リスト"]
-  },
+  "technicalConsiderations": {"constraints": ["リスト"], "risks": ["リスト"], "dependencies": ["リスト"]},
   "scopeDependencies": [
-    {
-      "question": "規模に影響する具体的な質問",
-      "impact": { "if_yes": "large", "if_no": "medium" }
-    }
+    {"question": "規模に影響する具体的な質問", "impact": {"if_yes": "large", "if_no": "medium"}}
   ],
   "questions": [
-    {
-      "category": "boundary|existing_code|dependencies",
-      "question": "具体的な質問",
-      "options": ["A", "B", "C"]
-    }
+    {"category": "boundary|existing_code|dependencies", "question": "具体的な質問", "options": ["A", "B", "C"]}
   ]
 }
 ```

package/.claude/agents-ja/rule-advisor.md

@@ -59,24 +59,11 @@ task-analyzerスキル（frontmatterで自動読み込み）が提供するも
 
 ```json
 {
-  "taskAnalysis": {
-    "taskType": "実装|修正|リファクタリング|設計|品質改善",
-    "essence": "根本目的", "estimatedFiles": 3, "scale": "small|medium|large",
-    "extractedTags": ["implementation", "testing", "security"]
-  },
+  "taskAnalysis": {"taskType": "実装|修正|リファクタリング|設計|品質改善", "essence": "根本目的", "estimatedFiles": 3, "scale": "small|medium|large", "extractedTags": ["implementation", "testing", "security"]},
   "selectedSkills": [
-    {
-      "skill": "coding-standards",
-      "sections": [{"title": "セクション名", "content": "## セクション内容..."}],
-      "reason": "必要な理由", "priority": "high"
-    }
+    {"skill": "coding-standards", "sections": [{"title": "セクション名", "content": "## セクション内容..."}], "reason": "必要な理由", "priority": "high"}
   ],
-  "metaCognitiveGuidance": {
-    "taskEssence": "表面作業でなく根本目的の理解",
-    "pastFailures": ["エラー修正衝動", "一度に大変更", "テスト不足"],
-    "potentialPitfalls": ["根本原因分析なし", "段階的アプローチなし", "テストなし"],
-    "firstStep": {"action": "最初のアクション", "rationale": "なぜ最初か"}
-  },
+  "metaCognitiveGuidance": {"taskEssence": "表面作業でなく根本目的の理解", "pastFailures": ["エラー修正衝動", "一度に大変更", "テスト不足"], "potentialPitfalls": ["根本原因分析なし", "段階的アプローチなし", "テストなし"], "firstStep": {"action": "最初のアクション", "rationale": "なぜ最初か"}},
   "metaCognitiveQuestions": ["最重要品質基準は？", "類似タスクでの過去の問題は？", "どこから着手？"],
   "warningPatterns": [
     {"pattern": "一度に大変更", "risk": "高複雑性", "mitigation": "フェーズ分割"},

package/.claude/agents-ja/scope-discoverer.md

@@ -164,17 +164,8 @@ skills: documentation-criteria, coding-standards, technical-spec, implementation
       "entryPoints": ["/path1", "/path2"],
       "relatedFiles": ["src/feature/*"],
       "dependencies": ["UNIT-002"],
-      "valueProfile": {
-        "targetPersona": "この機能が誰向けか（例: 'エンドユーザー', '管理者', '開発者'）",
-        "userGoal": "この機能でユーザーが達成したいこと",
-        "valueCategory": "属する上位機能（例: '認証', 'コンテンツ管理', 'レポーティング'）"
-      },
-      "technicalProfile": {
-        "primaryModules": ["src/<feature>/module-a.ts", "src/<feature>/module-b.ts"],
-        "publicInterfaces": ["ServiceA.operation()", "ModuleB.handle()"],
-        "dataFlowSummary": "入力元 → 主要処理経路 → 出力先",
-        "infrastructureDeps": ["外部依存リスト"]
-      },
+      "valueProfile": {"targetPersona": "この機能が誰向けか（例: 'エンドユーザー', '管理者', '開発者'）", "userGoal": "この機能でユーザーが達成したいこと", "valueCategory": "属する上位機能（例: '認証', 'コンテンツ管理', 'レポーティング'）"},
+      "technicalProfile": {"primaryModules": ["src/<feature>/module-a.ts", "src/<feature>/module-b.ts"], "publicInterfaces": ["ServiceA.operation()", "ModuleB.handle()"], "dataFlowSummary": "入力元 → 主要処理経路 → 出力先", "infrastructureDeps": ["外部依存リスト"]},
       "unitInventory": {
         "routes": [
           {"method": "POST", "path": "/api/auth/login", "handler": "AuthController.handleLogin", "file": "routes:15"}
@@ -189,28 +180,13 @@ skills: documentation-criteria, coding-standards, technical-spec, implementation
     }
   ],
   "relationships": [
-    {
-      "from": "UNIT-001",
-      "to": "UNIT-002",
-      "type": "depends_on|extends|shares_data"
-    }
+    {"from": "UNIT-001", "to": "UNIT-002", "type": "depends_on|extends|shares_data"}
   ],
   "uncertainAreas": [
-    {
-      "area": "領域名",
-      "reason": "不確実な理由",
-      "suggestedAction": "推奨アクション"
-    }
+    {"area": "領域名", "reason": "不確実な理由", "suggestedAction": "推奨アクション"}
   ],
   "prdUnits": [
-    {
-      "id": "PRD-001",
-      "name": "PRDユニット名（ユーザー価値レベル）",
-      "description": "この機能がユーザーに提供する価値",
-      "sourceUnits": ["UNIT-001", "UNIT-003"],
-      "combinedRelatedFiles": ["src/feature-a/*", "src/feature-b/*"],
-      "combinedEntryPoints": ["/path1", "/path2", "/path3"]
-    }
+    {"id": "PRD-001", "name": "PRDユニット名（ユーザー価値レベル）", "description": "この機能がユーザーに提供する価値", "sourceUnits": ["UNIT-001", "UNIT-003"], "combinedRelatedFiles": ["src/feature-a/*", "src/feature-b/*"], "combinedEntryPoints": ["/path1", "/path2", "/path3"]}
   ],
   "limitations": ["発見できなかった内容とその理由"]
 }

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

@@ -100,22 +100,11 @@ coding-standardsのSecurity Principlesの各原則に対して実装を検証:
   "summary": "[1-2文の要約]",
   "filesReviewed": 5,
   "findings": [
-    {
-      "category": "confirmed_risk|suspected_risk|defense_gap|hardening|policy",
-      "confidence": "high|medium|low",
-      "location": "[file:line]",
-      "description": "[検出された具体的な問題]",
-      "rationale": "[カテゴリ別、上記参照]",
-      "suggestion": "[具体的な修正方法]"
-    }
+    {"category": "confirmed_risk|suspected_risk|defense_gap|hardening|policy", "confidence": "high|medium|low", "location": "[file:line]", "description": "[検出された具体的な問題]", "rationale": "[カテゴリ別、上記参照]", "suggestion": "[具体的な修正方法]"}
   ],
   "notes": "[hardening/policy検出結果の要約、statusがapproved_with_notesの場合に提示]",
   "requiredFixes": [
-    {
-      "location": "[file:line — Fix Mode の許可リスト拡張のため file[:line] として解釈可能であること]",
-      "issue": "[修正対象の具体的な問題 — 対応する finding から取得]",
-      "fix": "[具体的な修正指示]"
-    }
+    {"location": "[file:line — Fix Mode の許可リスト拡張のため file[:line] として解釈可能であること]", "issue": "[修正対象の具体的な問題 — 対応する finding から取得]", "fix": "[具体的な修正指示]"}
   ]
 }
 ```

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

@@ -152,17 +152,14 @@ description: {生成したdescription}
 {
   "mode": "creation|modification",
   "skillName": "...",
-  "frontmatter": {
-    "name": "...",
-    "description": "..."
-  },
+  "frontmatter": {"name": "...", "description": "..."},
   "body": "frontmatter以降のmarkdownコンテンツ全文",
   "references": [
-    { "filename": "...", "content": "..." }
+    {"filename": "...", "content": "..."}
   ],
   "optimizationReport": {
     "issuesFound": [
-      { "pattern": "BP-XXX", "severity": "P1/P2/P3", "location": "...", "transform": "..." }
+      {"pattern": "BP-XXX", "severity": "P1/P2/P3", "location": "...", "transform": "..."}
     ],
     "researchFindings": [],
     "lineCount": 0,

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

@@ -102,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 から導出）
@@ -222,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スキルのタスクテンプレートを参照。
@@ -359,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

@@ -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

@@ -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 に追加してリトライ", "別タスクに分割", "アプローチを再検討"]
 }