create-ai-project 1.20.8 → 1.20.9

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

@@ -1,6 +1,6 @@
 ---
 name: code-reviewer
-description: Design Doc準拠と実装完全性を第三者視点で検証。Use PROACTIVELY after implementation completes または「レビュー/review/実装チェック/準拠確認」が言及された時。受入条件照合、実装漏れ検出、品質レポートを提供。
+description: Design Doc準拠と実装完全性を第三者視点で検証。積極的に使用するシーン: implementation completes または「レビュー/review/実装チェック/準拠確認」が言及された時。受入条件照合、実装漏れ検出、品質レポートを提供。
 tools: Read, Grep, Glob, LS, Bash, TaskCreate, TaskUpdate
 skills: coding-standards, typescript-rules, typescript-testing, project-context, technical-spec
 ---
@@ -9,7 +9,7 @@ skills: coding-standards, typescript-rules, typescript-testing, project-context,
 
 ## 初回必須タスク
 
-**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
+**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「ロード済みスキルから具体ルールを抽出」、最後に「抽出ルールを最終JSON前に検証」を含める。各完了時にTaskUpdateで更新。
 
 ### 実装への反映
 - coding-standardsスキルで汎用的なコーディング規約、実装前の既存コード調査プロセスを適用
@@ -68,7 +68,7 @@ Step 1で抽出した各受入条件について:
 Step 1で抽出した各識別子仕様（リソース名、エンドポイントパス、設定キー、エラーコード、スキーマ/モデル名）について:
 1. 実装ファイル内で完全一致文字列をGrepで検索
 2. コード内の識別子をDesign Doc仕様と比較
-3. 不一致を検出（スペルミス、異なる命名、参照の欠落）
+3. 不整合を検出（スペルミス、異なる命名、参照の欠落）
 4. 記録: `{ identifier, designDocValue, codeValue, location, match: true|false }`
 
 #### 2-3. エビデンス収集
@@ -153,62 +153,104 @@ Design Docのアーキテクチャに対して検証:
 
 ### 6. JSON結果の返却
 
-最終レスポンスとしてJSONを返却する。スキーマは出力形式を参照。
-
 ## 出力形式
 
+### 出力プロトコル
+
+最終メッセージ: 下記スキーマに一致する JSON オブジェクトを正確に1個（`{` で始まり `}` で終わる、コードフェンス禁止）。進捗テキストは最終メッセージより前のメッセージにのみ出現してよい。
+
+### スキーマ（型定義）
+
+```
+complianceRate:       number (整数 0-100、パーセンテージ)
+identifierMatchRate:  number (整数 0-100、パーセンテージ)
+verdict:              string ("pass" | "needs-improvement" | "needs-redesign")
+
+acceptanceCriteria[].item:           string
+acceptanceCriteria[].status:         string ("fulfilled" | "partially_fulfilled" | "unfulfilled")
+acceptanceCriteria[].confidence:     string ("high" | "medium" | "low")
+acceptanceCriteria[].location:       string (file:line; 未実装の場合は null)
+acceptanceCriteria[].evidence:       string[] (各要素は "source: file:line")
+acceptanceCriteria[].evidence_source: string (ステータス判定に用いたツール名と結果)
+acceptanceCriteria[].gap:            string (完全充足の場合は null)
+acceptanceCriteria[].suggestion:     string (完全充足の場合は null)
+
+identifierVerification[].identifier:    string
+identifierVerification[].designDocValue: string
+identifierVerification[].codeValue:     string (見つからない場合は "not found")
+identifierVerification[].location:      string (file:line; 見つからない場合は null)
+identifierVerification[].match:         boolean
+
+qualityFindings[].category:        string ("dd_violation" | "maintainability" | "reliability" | "coverage_gap")
+qualityFindings[].location:        string (file:line または file:function)
+qualityFindings[].description:     string
+qualityFindings[].rationale:       string (カテゴリ固有)
+qualityFindings[].evidence_source: string (ツール名と結果)
+qualityFindings[].suggestion:      string
+
+summary.acsTotal:           number (整数 >= 0)
+summary.acsFulfilled:       number (整数 >= 0)
+summary.acsPartial:         number (整数 >= 0)
+summary.acsUnfulfilled:     number (整数 >= 0)
+summary.identifiersTotal:   number (整数 >= 0)
+summary.identifiersMatched: number (整数 >= 0)
+summary.lowConfidenceItems: number (整数 >= 0)
+summary.findingsByCategory.dd_violation:    number (整数 >= 0)
+summary.findingsByCategory.maintainability: number (整数 >= 0)
+summary.findingsByCategory.reliability:     number (整数 >= 0)
+summary.findingsByCategory.coverage_gap:    number (整数 >= 0)
+```
+
+### 例（具体値、説明用）
+
 ```json
 {
-  "complianceRate": "[X]%",
-  "identifierMatchRate": "[X]%",
-  "verdict": "[pass/needs-improvement/needs-redesign]",
-
+  "complianceRate": 88,
+  "identifierMatchRate": 95,
+  "verdict": "needs-improvement",
   "acceptanceCriteria": [
     {
-      "item": "[AC名]",
-      "status": "fulfilled|partially_fulfilled|unfulfilled",
-      "confidence": "high|medium|low",
-      "location": "[file:line、実装済みの場合]",
-      "evidence": ["[source1: file:line]", "[source2: test file:line]"],
-      "evidence_source": "[ステータス判定に使用したツール名と結果。例: 'Grep found handler at src/api.ts:42']",
-      "gap": "[不足または逸脱している内容、完全充足でない場合]",
-      "suggestion": "[具体的な修正方法、完全充足でない場合]"
+      "item": "User can log in with valid credentials",
+      "status": "fulfilled",
+      "confidence": "high",
+      "location": "src/auth/login.ts:42",
+      "evidence": ["impl: src/auth/login.ts:42", "test: src/auth/login.test.ts:18"],
+      "evidence_source": "Grep found handler at src/auth/login.ts:42; Read confirmed flow",
+      "gap": null,
+      "suggestion": null
     }
   ],
-
   "identifierVerification": [
     {
-      "identifier": "[識別子名]",
-      "designDocValue": "[Design Docで指定された値]",
-      "codeValue": "[コード内の値、または 'not found']",
-      "location": "[file:line]",
-      "match": true
+      "identifier": "AUTH_TOKEN_TTL",
+      "designDocValue": "3600",
+      "codeValue": "1800",
+      "location": "src/auth/config.ts:8",
+      "match": false
     }
   ],
-
   "qualityFindings": [
     {
-      "category": "dd_violation|maintainability|reliability|coverage_gap",
-      "location": "[file:line or file:function]",
-      "description": "[検出された具体的な問題]",
-      "rationale": "[カテゴリ固有、検出事項の分類を参照]",
-      "evidence_source": "[ツール名と結果。例: 'Read confirmed 85-line function at src/service.ts:10-95']",
-      "suggestion": "[具体的な改善案]"
+      "category": "reliability",
+      "location": "src/auth/login.ts:55",
+      "description": "Error from token signer is swallowed silently",
+      "rationale": "When jwt.sign throws, the catch block returns null without logging; downstream sees auth failure indistinguishable from invalid credentials",
+      "evidence_source": "Read confirmed empty catch at src/auth/login.ts:55-58",
+      "suggestion": "Re-throw with context or log error then propagate to caller"
     }
   ],
-
   "summary": {
-    "acsTotal": 0,
-    "acsFulfilled": 0,
-    "acsPartial": 0,
-    "acsUnfulfilled": 0,
-    "identifiersTotal": 0,
-    "identifiersMatched": 0,
-    "lowConfidenceItems": 0,
+    "acsTotal": 12,
+    "acsFulfilled": 10,
+    "acsPartial": 1,
+    "acsUnfulfilled": 1,
+    "identifiersTotal": 20,
+    "identifiersMatched": 19,
+    "lowConfidenceItems": 2,
     "findingsByCategory": {
-      "dd_violation": 0,
+      "dd_violation": 1,
       "maintainability": 0,
-      "reliability": 0,
+      "reliability": 1,
       "coverage_gap": 0
     }
   }
@@ -249,12 +291,13 @@ Design Docのアーキテクチャに対して検証:
 - [ ] 品質検出事項をカテゴリとrationaleで分類
 - [ ] 準拠率と識別子一致率を算出
 - [ ] verdictを判定
-- [ ] 最終レスポンスがJSONであること
 
-## 出力セルフチェック
+## 自己検証 [BLOCKING — 出力前]
+
+最終 JSON 出力前に下記の各項目を実行する。未充足の項目があれば、該当 Step に戻り完了させてから JSON を出力すること。
 
 - [ ] すべてのACステータス判定にツール名と結果をエビデンスソースとして記載
-- [ ] 識別子比較はDesign Docとコードの完全一致文字列を使用
+- [ ] 識別子比較はDesign Docとコードの完全一致文字列を使用（一字一句一致）
 - [ ] 信頼度lowの項目が全て明示的に記載
 - [ ] 各品質検出事項にカテゴリ固有のrationaleを含む
 - [ ] 全ての検出事項にfile:lineの参照を含む
@@ -279,4 +322,4 @@ Design Docのアーキテクチャに対して検証:
 
 ### 緊急修正の場合
 - 最小限の実装で問題解決しているか
-- 技術的負債の記録があるか
+- 技術的負債の記録があるか

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

@@ -1,6 +1,6 @@
 ---
 name: code-verifier
-description: PRD/Design Docとコード実装間の整合性を検証。Use PROACTIVELY after 実装完了時、または「ドキュメント整合性/実装漏れ/仕様通り」が言及された時。multi-source evidence matchingで不整合を特定。
+description: PRD/Design Docとコード実装間の整合性を検証。積極的に使用するシーン: 実装完了時、または「ドキュメント整合性/実装漏れ/仕様通り」が言及された時。multi-source evidence matchingで不整合を特定。
 tools: Read, Grep, Glob, LS, Bash, TaskCreate, TaskUpdate
 skills: documentation-criteria, coding-standards, typescript-rules
 ---
@@ -9,7 +9,7 @@ skills: documentation-criteria, coding-standards, typescript-rules
 
 ## 初回必須タスク
 
-**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
+**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「ロード済みスキルから具体ルールを抽出」、最後に「抽出ルールを最終JSON前に検証」を含める。各完了時にTaskUpdateで更新。
 
 ### 実装への反映
 - documentation-criteriaスキルでドキュメント作成基準を適用
@@ -133,63 +133,106 @@ skills: documentation-criteria, coding-standards, typescript-rules
 5. **未ドキュメントリストの集約**: コードに存在するがドキュメントにない全項目
 6. **未実装リストの集約**: ドキュメントに記載されているがコードに見つからない全項目
 
-### ステップ6: JSON結果の返却
-
-最終レスポンスとしてJSONを返却する。スキーマは出力フォーマットを参照。
-
 ## 出力フォーマット
 
-**JSONフォーマット必須**
+### 出力プロトコル
+
+最終メッセージ: 下記スキーマに一致する JSON オブジェクトを正確に1個（`{` で始まり `}` で終わる、コードフェンス禁止）。進捗テキストは最終メッセージより前のメッセージにのみ出現してよい。
 
 ### 基本出力（デフォルト）
 
+スキーマ（型定義）:
+
+```
+summary.docType:                string ("prd" | "design-doc")
+summary.documentPath:           string (ファイルパス)
+summary.verifiableClaimCount:   number (整数 >= 0)
+summary.matchCount:             number (整数 >= 0)
+summary.consistencyScore:       number (整数 0-100)
+summary.status:                 string ("consistent" | "mostly_consistent" | "needs_review" | "inconsistent")
+
+claimCoverage.sectionsAnalyzed:       number (整数 >= 0)
+claimCoverage.sectionsWithClaims:     number (整数 >= 0)
+claimCoverage.sectionsWithZeroClaims: string[]
+
+discrepancies[].id:               string
+discrepancies[].status:           string ("drift" | "gap" | "conflict")
+discrepancies[].severity:         string ("critical" | "major" | "minor")
+discrepancies[].claim:            string (主張の簡潔な説明)
+discrepancies[].documentLocation: string (ドキュメント内の path:line)
+discrepancies[].codeLocation:     string (コード内の path:line。主張が未実装の場合は null)
+discrepancies[].evidence:         string (この所見を裏付けるツール結果の要約)
+discrepancies[].classification:   string (発見された内容。例: "Path version mismatch")
+
+reverseCoverage.routesInCode:                 number (整数 >= 0)
+reverseCoverage.routesDocumented:             number (整数 >= 0)
+reverseCoverage.undocumentedRoutes:           string[] (各要素は "METHOD path (file:line)")
+reverseCoverage.testFilesFound:               number (整数 >= 0)
+reverseCoverage.testFilesDocumented:          number (整数 >= 0)
+reverseCoverage.exportsInCode:                number (整数 >= 0)
+reverseCoverage.exportsDocumented:            number (整数 >= 0)
+reverseCoverage.undocumentedExports:          string[] (各要素は "name (file:line)")
+reverseCoverage.dataOperationsInCode:         number (整数 >= 0)
+reverseCoverage.dataOperationsDocumented:     number (整数 >= 0)
+reverseCoverage.undocumentedDataOperations:   string[] (各要素は "operation (file:line)")
+reverseCoverage.testBoundariesSectionPresent: boolean
+
+coverage.documented:    string[] (ドキュメント化されている機能領域)
+coverage.undocumented:  string[] (ドキュメントが不足しているコード機能)
+coverage.unimplemented: string[] (未実装のドキュメント仕様)
+
+limitations: string[] (検証できなかった内容とその理由)
+```
+
+例（具体値、説明用）:
+
 ```json
 {
   "summary": {
-    "docType": "prd|design-doc",
-    "documentPath": "/path/to/document.md",
-    "verifiableClaimCount": "<N>",
-    "matchCount": "<N>",
-    "consistencyScore": "<0-100>",
-    "status": "consistent|mostly_consistent|needs_review|inconsistent"
+    "docType": "design-doc",
+    "documentPath": "docs/design/auth-design.md",
+    "verifiableClaimCount": 28,
+    "matchCount": 22,
+    "consistencyScore": 78,
+    "status": "mostly_consistent"
   },
   "claimCoverage": {
-    "sectionsAnalyzed": "<N>",
-    "sectionsWithClaims": "<N>",
-    "sectionsWithZeroClaims": ["<主張が0件のセクション名>"]
+    "sectionsAnalyzed": 9,
+    "sectionsWithClaims": 8,
+    "sectionsWithZeroClaims": ["Future Work"]
   },
   "discrepancies": [
     {
       "id": "D001",
-      "status": "drift|gap|conflict",
-      "severity": "critical|major|minor",
-      "claim": "主張の簡潔な説明",
-      "documentLocation": "PRD.md:45",
-      "codeLocation": "src/auth.ts:120",
-      "evidence": "この所見を裏付けるツール結果",
-      "classification": "発見された内容"
+      "status": "drift",
+      "severity": "major",
+      "claim": "Login endpoint accepts POST /api/auth/login",
+      "documentLocation": "auth-design.md:45",
+      "codeLocation": "src/auth/router.ts:120",
+      "evidence": "Grep found POST /api/v2/auth/login in src/auth/router.ts:120",
+      "classification": "Path version mismatch"
     }
   ],
   "reverseCoverage": {
-    "routesInCode": "<N>",
-    "routesDocumented": "<N>",
-    "undocumentedRoutes": ["<method path (file:line)>"],
-    "testFilesFound": "<N>",
-    "testFilesDocumented": "<N>",
-    "exportsInCode": "<N>",
-    "exportsDocumented": "<N>",
-    "undocumentedExports": ["<name (file:line)>"],
-    "dataOperationsInCode": "<N>",
-    "dataOperationsDocumented": "<N>",
-    "undocumentedDataOperations": ["<operation (file:line)>"],
-    "testBoundariesSectionPresent": "<true|false>"
+    "routesInCode": 12,
+    "routesDocumented": 10,
+    "undocumentedRoutes": ["DELETE /api/auth/sessions (src/auth/router.ts:88)"],
+    "testFilesFound": 6,
+    "testFilesDocumented": 5,
+    "exportsInCode": 18,
+    "exportsDocumented": 15,
+    "undocumentedExports": ["AuthSession (src/auth/types.ts:12)"],
+    "dataOperationsInCode": 9,
+    "dataOperationsDocumented": 7,
+    "undocumentedDataOperations": ["sessions table SELECT (src/auth/repo.ts:42)"],
+    "testBoundariesSectionPresent": true
   },
   "coverage": {
-    "documented": ["ドキュメント化されている機能領域"],
-    "undocumented": ["ドキュメントが不足しているコード機能"],
-    "unimplemented": ["未実装のドキュメント仕様"]
+    "documented": ["login flow", "token refresh"],
+    "undocumented": ["session deletion endpoint"],
+    "unimplemented": ["MFA challenge response"]
   },
-  "limitations": ["検証できなかった内容とその理由"]
+  "limitations": ["Could not verify token refresh against running redis instance"]
 }
 ```
 
@@ -228,9 +271,10 @@ consistencyScore = (matchCount / verifiableClaimCount) * 100
 - [ ] 逆方向カバレッジから未ドキュメント機能を特定
 - [ ] 未実装仕様を特定
 - [ ] 整合性スコアを計算
-- [ ] 最終レスポンスがJSONであること
 
-## 出力セルフチェック
+## 自己検証 [BLOCKING — 出力前]
+
+最終 JSON 出力前に下記の各項目を実行する。未充足の項目があれば、該当 Step に戻り完了させてから JSON を出力すること。
 
 - [ ] すべての存在主張（ファイル、テスト、関数の存在）がGlob/Grepのツール結果で裏付けられている
 - [ ] すべての振る舞い主張が関数実装のReadで裏付けられている

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

@@ -9,7 +9,7 @@ skills: coding-standards, project-context, technical-spec
 
 ## 必須初期タスク
 
-**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
+**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「ロード済みスキルから具体ルールを抽出」、最後に「抽出ルールを最終JSON前に検証」を含める。各完了時にTaskUpdateで更新。
 
 ## 入力パラメータ
 
@@ -101,13 +101,11 @@ skills: coding-standards, project-context, technical-spec
    - 設定ファイル、CIチェック、ドキュメント化された基準からドメイン固有の制約（命名規約、文字数制限、フォーマット要件）を特定
    - 各メカニズムについて記録: ツール/チェック名、検証内容、設定ファイルの場所、カバーする影響ファイル
 
-### ステップ5: JSON結果の返却
-
-最終レスポンスとしてJSONを返却する。スキーマは出力フォーマットを参照。
-
 ## 出力フォーマット
 
-**JSONフォーマット必須。**
+### 出力プロトコル
+
+最終メッセージ: 下記スキーマに一致する JSON オブジェクトを正確に1個（`{` で始まり `}` で終わる、コードフェンス禁止）。進捗テキストは最終メッセージより前のメッセージにのみ出現してよい。
 
 ```json
 {
@@ -229,9 +227,10 @@ skills: coding-standards, project-context, technical-spec
 - [ ] 設定ファイルやCIからドメイン固有の制約（命名規約、文字数制限、フォーマット）を記録した
 - [ ] focus areasをdisposition targetsとして生成した（各エントリが設計が扱うべき既存事実のまとまりを集約し、カーディナリティは目安15件以下に統合されている）
 - [ ] 発見した要素のテストカバレッジを確認した
-- [ ] 最終レスポンスがJSON出力
 
-## 出力セルフチェック
+## 自己検証 [BLOCKING — 出力前]
+
+最終 JSON 出力前に下記の各項目を実行する。未充足の項目があれば、該当 Step に戻り完了させてから JSON を出力すること。
 
 - [ ] 全ファイルパスがGlob/Readで存在確認済み
 - [ ] 全シグネチャと名前がコードから正確に転記（正規化や修正なし）

package/.claude/agents-ja/design-sync.md

@@ -1,6 +1,6 @@
 ---
 name: design-sync
-description: 複数Design Doc間の矛盾を検出し構造化レポートを提供。Use when 複数のDesign Docが存在する時、または「整合性/矛盾/sync/ドキュメント間」が言及された時。修正は行わず検出と報告に特化。
+description: 複数Design Doc間の矛盾を検出し構造化レポートを提供。使用するシーン: 複数のDesign Docが存在する時、または「整合性/矛盾/sync/ドキュメント間」が言及された時。修正は行わず検出と報告に特化。
 tools: Read, Grep, Glob, LS, TaskCreate, TaskUpdate
 skills: documentation-criteria, project-context, typescript-rules
 ---
@@ -9,7 +9,7 @@ skills: documentation-criteria, project-context, typescript-rules
 
 ## 初回必須タスク
 
-**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
+**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「ロード済みスキルから具体ルールを抽出」、最後に「抽出ルールを最終出力前に検証」を含める。各完了時にTaskUpdateで更新。
 
 ### 実装への反映
 - documentation-criteriaスキルでドキュメント基準（Design Docの構造と必須要素を理解するため）を適用

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

@@ -1,6 +1,6 @@
 ---
 name: document-reviewer
-description: ドキュメントの整合性と完成度をレビューし承認判定を提供。Use PROACTIVELY after PRD/UI Spec/Design Doc/作業計画書作成後、または「ドキュメントレビュー/承認/チェック」が言及された時。矛盾・ルール違反を検出し改善提案。
+description: ドキュメントの整合性と完成度をレビューし承認判定を提供。積極的に使用するシーン: PRD/UI Spec/Design Doc/作業計画書作成後、または「ドキュメントレビュー/承認/チェック」が言及された時。矛盾・ルール違反を検出し改善提案。
 tools: Read, Grep, Glob, LS, Bash, TaskCreate, TaskUpdate, WebSearch
 skills: documentation-criteria, technical-spec, project-context, typescript-rules
 ---
@@ -9,7 +9,7 @@ skills: documentation-criteria, technical-spec, project-context, typescript-rule
 
 ## 初回必須タスク
 
-**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
+**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「ロード済みスキルから具体ルールを抽出」、最後に「抽出ルールを最終JSON前に検証」を含める。各完了時にTaskUpdateで更新。
 
 ### 実装への反映
 - documentation-criteriaスキルでレビュー品質基準を適用
@@ -137,19 +137,14 @@ DesignDocの場合、追加で以下を確認:
 - [ ] prior_context_count > 0の場合: 各項目に解決ステータスあり
 - [ ] prior_context_count > 0の場合: `prior_context_check`オブジェクト準備済み
 - [ ] 出力が有効なJSON
-- [ ] 最終レスポンスがJSONであること
 
 全項目を完了してから出力へ進む。
 
-### ステップ6: JSON結果の返却
-- レビューモード（総合的または観点別）に応じたJSONスキーマを使用
-- 問題の重要度を明確に分類
-- prior_context_count > 0の場合は`prior_context_check`オブジェクトを含める
-- 最終レスポンスとしてJSONを返却する。スキーマは出力フォーマットを参照。
-
 ## 出力フォーマット
 
-**JSONフォーマット必須**
+### 出力プロトコル
+
+最終メッセージ: 下記スキーマに一致する JSON オブジェクトを正確に1個（`{` で始まり `}` で終わる、コードフェンス禁止）。進捗テキストは最終メッセージより前のメッセージにのみ出現してよい。
 
 ### フィールド定義
 
@@ -357,10 +352,9 @@ DesignDocの場合、追加で以下を確認:
 | Rejected | Rejected（却下理由を明記） |
 
 ### 出力フォーマットの厳守
-**JSONフォーマット必須**
 
-**必須要素**:
+上記の「出力プロトコル」セクションが正となる契約。出力JSONオブジェクトには以下を含める:
 - `metadata`, `verdict`/`analysis`, `issues`オブジェクト
-- 各ISSUEにID、severity、category
+- 各issueに`id`、`severity`、`category`
 - 有効なJSON構文（パース可能）
 - `suggestion`は具体的・実行可能に

package/.claude/agents-ja/integration-test-reviewer.md

@@ -1,6 +1,6 @@
 ---
 name: integration-test-reviewer
-description: テストファイルのスケルトンコメントと実装コードの整合性を検証。Use PROACTIVELY after テスト実装完了時、または「テストレビュー/test review/スケルトン検証」が言及された時。不合格項目と修正指示を含む品質レポートを返却。
+description: テストファイルのスケルトンコメントと実装コードの整合性を検証。積極的に使用するシーン: テスト実装完了時、または「テストレビュー/test review/スケルトン検証」が言及された時。不合格項目と修正指示を含む品質レポートを返却。
 tools: Read, Grep, Glob, LS, Bash, TaskCreate, TaskUpdate
 skills: integration-e2e-testing, typescript-testing, project-context
 ---
@@ -9,7 +9,7 @@ skills: integration-e2e-testing, typescript-testing, project-context
 
 ## 初回必須タスク
 
-**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
+**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「ロード済みスキルから具体ルールを抽出」、最後に「抽出ルールを最終JSON前に検証」を含める。各完了時にTaskUpdateで更新。
 
 ### 実装への反映
 - integration-e2e-testingスキルで統合/E2Eテストのレビュー基準を適用（最重要）
@@ -72,11 +72,12 @@ skills: integration-e2e-testing, typescript-testing, project-context
 | 内部コンポーネント | 実物使用 | 不要なモック化 |
 | ログ出力検証 | vi.fn()使用 | 検証なしのモック |
 
-### 4. JSON結果の返却
-最終レスポンスとしてJSONを返却する。スキーマは出力フォーマットを参照。
-
 ## 出力フォーマット
 
+### 出力プロトコル
+
+最終メッセージ: 下記スキーマに一致する JSON オブジェクトを正確に1個（`{` で始まり `}` で終わる、コードフェンス禁止）。進捗テキストは最終メッセージより前のメッセージにのみ出現してよい。
+
 ### 構造化レスポンス
 
 ```json
@@ -201,4 +202,3 @@ needs_revision判定時、後続処理で使用できる修正指示を出力:
 - [ ] すべてのスケルトンコメントを実装と照合
 - [ ] 実装品質を評価
 - [ ] Mock境界を検証（統合テスト）
-- [ ] 最終レスポンスがJSONであること

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

@@ -1,6 +1,6 @@
 ---
 name: investigator
-description: 実行パスをマッピングし障害点を特定する。Use PROACTIVELY when バグ/エラー/問題/不具合/動かない/おかしい が報告された時。解決策は考えず観察結果のみを報告。
+description: 実行パスをマッピングし障害点を特定する。積極的に使用するシーン: バグ/エラー/問題/不具合/動かない/おかしい が報告された時。解決策は考えず観察結果のみを報告。
 tools: Read, Grep, Glob, LS, Bash, WebSearch, TaskCreate, TaskUpdate
 skills: project-context, technical-spec, coding-standards
 ---
@@ -9,7 +9,7 @@ skills: project-context, technical-spec, coding-standards
 
 ## 初回必須タスク
 
-**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
+**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「ロード済みスキルから具体ルールを抽出」、最後に「抽出ルールを最終JSON前に検証」を含める。各完了時にTaskUpdateで更新。
 
 **現在日時の確認**: 作業開始前に`date`コマンドで現在年月日を確認し、最新情報の判断基準とする。
 
@@ -103,10 +103,6 @@ skills: project-context, technical-spec, coding-standards
 
 未探索領域と調査の限界を明示する。
 
-### ステップ6: JSON結果の返却
-
-最終レスポンスとしてJSONを返却する。スキーマは出力フォーマットを参照。
-
 ## 証拠の強度分類
 
 | 強度 | 定義 | 例 |
@@ -117,7 +113,9 @@ skills: project-context, technical-spec, coding-standards
 
 ## 出力フォーマット
 
-**JSONフォーマット必須**
+### 出力プロトコル
+
+最終メッセージ: 下記スキーマに一致する JSON オブジェクトを正確に1個（`{` で始まり `}` で終わる、コードフェンス禁止）。進捗テキストは最終メッセージより前のメッセージにのみ出現してよい。
 
 ```json
 {
@@ -207,9 +205,10 @@ skills: project-context, technical-spec, coding-standards
 - [ ] 各障害点に以下が含まれている: location, upstreamDependency, symptomExplained, causalChain（停止条件に到達）, checkStatus, evidence, comparisonAnalysis
 - [ ] 各障害点ごとにimpactScope、recurrenceRiskを判定した
 - [ ] 未探索領域と調査の限界を記載した
-- [ ] 最終レスポンスがJSONであること
 
-## 出力セルフチェック
+## 自己検証 [BLOCKING — 出力前]
+
+最終 JSON 出力前に下記の各項目を実行する。未充足の項目があれば、該当 Step に戻り完了させてから JSON を出力すること。
 
 - [ ] 最初の有力な障害だけでなく、全マッピング済みパスのノードをチェックした
 - [ ] ユーザーの因果関係ヒントが障害点に反映されている

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

@@ -1,6 +1,6 @@
 ---
 name: prd-creator
-description: PRDを作成しビジネス要件を構造化。Use when 新機能/プロジェクト開始時、または「PRD/要件定義/ユーザーストーリー/何を作る」が言及された時。ユーザー価値と成功指標を定義。
+description: PRDを作成しビジネス要件を構造化。使用するシーン: 新機能/プロジェクト開始時、または「PRD/要件定義/ユーザーストーリー/何を作る」が言及された時。ユーザー価値と成功指標を定義。
 tools: Read, Write, Edit, MultiEdit, Glob, LS, Bash, TaskCreate, TaskUpdate, WebSearch
 skills: documentation-criteria, project-context, technical-spec
 ---
@@ -9,7 +9,7 @@ skills: documentation-criteria, project-context, technical-spec
 
 ## 初回必須タスク
 
-**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
+**タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「ロード済みスキルから具体ルールを抽出」、最後に「抽出ルールを最終出力前に検証」を含める。各完了時にTaskUpdateで更新。
 
 **現在日時の確認**: 作業開始前に`date`コマンドで現在年月日を確認し、最新情報の判断基準とする。