create-ai-project 1.20.2 → 1.20.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/.claude/agents-en/acceptance-test-generator.md +3 -2
  2. package/.claude/agents-en/code-reviewer.md +133 -25
  3. package/.claude/agents-en/design-sync.md +5 -6
  4. package/.claude/agents-en/integration-test-reviewer.md +2 -2
  5. package/.claude/agents-en/prd-creator.md +2 -4
  6. package/.claude/agents-en/quality-fixer-frontend.md +1 -1
  7. package/.claude/agents-en/quality-fixer.md +1 -1
  8. package/.claude/agents-en/requirement-analyzer.md +7 -7
  9. package/.claude/agents-en/scope-discoverer.md +2 -2
  10. package/.claude/agents-en/solver.md +1 -2
  11. package/.claude/agents-en/task-decomposer.md +2 -2
  12. package/.claude/agents-en/task-executor-frontend.md +1 -1
  13. package/.claude/agents-en/task-executor.md +1 -1
  14. package/.claude/agents-en/technical-designer-frontend.md +5 -5
  15. package/.claude/agents-en/technical-designer.md +2 -2
  16. package/.claude/agents-en/ui-spec-designer.md +1 -1
  17. package/.claude/agents-en/work-planner.md +1 -1
  18. package/.claude/agents-ja/acceptance-test-generator.md +3 -2
  19. package/.claude/agents-ja/code-reviewer.md +133 -25
  20. package/.claude/agents-ja/design-sync.md +5 -5
  21. package/.claude/agents-ja/integration-test-reviewer.md +2 -2
  22. package/.claude/agents-ja/prd-creator.md +2 -4
  23. package/.claude/agents-ja/quality-fixer-frontend.md +1 -1
  24. package/.claude/agents-ja/quality-fixer.md +1 -1
  25. package/.claude/agents-ja/requirement-analyzer.md +7 -7
  26. package/.claude/agents-ja/scope-discoverer.md +2 -2
  27. package/.claude/agents-ja/solver.md +1 -2
  28. package/.claude/agents-ja/task-decomposer.md +2 -2
  29. package/.claude/agents-ja/task-executor-frontend.md +1 -1
  30. package/.claude/agents-ja/task-executor.md +1 -1
  31. package/.claude/agents-ja/technical-designer-frontend.md +5 -5
  32. package/.claude/agents-ja/technical-designer.md +2 -2
  33. package/.claude/agents-ja/ui-spec-designer.md +1 -1
  34. package/.claude/agents-ja/work-planner.md +1 -1
  35. package/.claude/commands-en/build.md +17 -8
  36. package/.claude/commands-en/front-build.md +25 -41
  37. package/.claude/commands-en/front-design.md +49 -17
  38. package/.claude/commands-en/front-plan.md +17 -10
  39. package/.claude/commands-en/front-review.md +37 -33
  40. package/.claude/commands-en/review.md +10 -5
  41. package/.claude/commands-ja/build.md +17 -8
  42. package/.claude/commands-ja/front-build.md +25 -41
  43. package/.claude/commands-ja/front-design.md +48 -18
  44. package/.claude/commands-ja/front-plan.md +22 -15
  45. package/.claude/commands-ja/front-review.md +37 -33
  46. package/.claude/commands-ja/review.md +10 -5
  47. package/.claude/skills-en/coding-standards/references/security-checks.md +4 -2
  48. package/.claude/skills-en/documentation-criteria/SKILL.md +8 -28
  49. package/.claude/skills-en/documentation-criteria/references/adr-template.md +5 -1
  50. package/.claude/skills-en/documentation-criteria/references/design-template.md +7 -8
  51. package/.claude/skills-en/documentation-criteria/references/plan-template.md +11 -6
  52. package/.claude/skills-en/documentation-criteria/references/prd-template.md +32 -10
  53. package/.claude/skills-en/documentation-criteria/references/task-template.md +2 -2
  54. package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +20 -37
  55. package/.claude/skills-en/task-analyzer/references/skills-index.yaml +0 -2
  56. package/.claude/skills-ja/coding-standards/references/security-checks.md +4 -2
  57. package/.claude/skills-ja/documentation-criteria/SKILL.md +8 -29
  58. package/.claude/skills-ja/documentation-criteria/references/adr-template.md +5 -1
  59. package/.claude/skills-ja/documentation-criteria/references/design-template.md +7 -2
  60. package/.claude/skills-ja/documentation-criteria/references/plan-template.md +11 -6
  61. package/.claude/skills-ja/documentation-criteria/references/prd-template.md +32 -10
  62. package/.claude/skills-ja/documentation-criteria/references/task-template.md +2 -2
  63. package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +20 -35
  64. package/.claude/skills-ja/task-analyzer/references/skills-index.yaml +0 -2
  65. package/CHANGELOG.md +40 -0
  66. package/README.ja.md +51 -30
  67. package/README.md +58 -34
  68. package/docs/guides/en/skills-editing-guide.md +10 -0
  69. package/docs/guides/ja/skills-editing-guide.md +12 -2
  70. package/package.json +1 -1
@@ -20,18 +20,9 @@ This document provides practical behavioral guidelines for me (Claude) to effici
20
20
  - **Analysis/Design**: Delegate to the appropriate specialist subagent
21
21
  - **First action**: Pass user requirements to requirement-analyzer before any other step
22
22
 
23
- **First Action Rule**: To accurately analyze user requirements, pass them directly to requirement-analyzer and determine the workflow based on its analysis results.
23
+ ### First Action Rule
24
24
 
25
- ## Decision Flow When Receiving Tasks
26
-
27
- ```mermaid
28
- graph TD
29
- Start[Receive New Task] --> RA[Analyze requirements with requirement-analyzer]
30
- RA --> Scale[Scale assessment]
31
- Scale --> Flow[Execute flow based on scale]
32
- ```
33
-
34
- **During flow execution, determine next subagent according to scale determination table**
25
+ When receiving a new task, pass user requirements directly to requirement-analyzer. Determine the workflow based on its scale assessment result.
35
26
 
36
27
  ### Requirement Change Detection During Flow
37
28
 
@@ -59,7 +50,7 @@ graph TD
59
50
  10. **technical-designer**: ADR/Design Doc creation (latest technology research, Property annotation assignment)
60
51
  11. **work-planner**: Work plan creation from Design Doc and test skeletons
61
52
  12. **document-reviewer**: Single document quality, completeness, and rule compliance check
62
- 13. **code-verifier**: Verify Design Doc claims against existing codebase (used pre-review in design flow)
53
+ 13. **code-verifier**: Verify document-code consistency. Pre-implementation: Design Doc claims against existing codebase. Post-implementation: implementation against Design Doc
63
54
  14. **design-sync**: Design Doc consistency verification (detects explicit conflicts only)
64
55
  15. **acceptance-test-generator**: Generate separate integration and E2E test skeletons from Design Doc ACs and optional UI Spec
65
56
 
@@ -141,7 +132,7 @@ Subagents respond in JSON format. Key fields for orchestrator decisions:
141
132
  |-------|-----------|----------------|
142
133
  | requirement-analyzer | scale, confidence, adrRequired, crossLayerScope, scopeDependencies, questions | Select flow by scale; check adrRequired for ADR step |
143
134
  | codebase-analyzer | analysisScope.categoriesDetected, dataModel.detected, focusAreas[], existingElements count, limitations | Pass focusAreas to technical-designer as context |
144
- | code-verifier | consistencyScore, discrepancies[], reverseCoverage (dataOperationsInCode, testBoundariesSectionPresent) | Flag discrepancies for document-reviewer |
135
+ | code-verifier | status (consistent/mostly_consistent/needs_review/inconsistent), consistencyScore, discrepancies[], reverseCoverage (dataOperationsInCode, testBoundariesSectionPresent). Pre-implementation: verifies Design Doc claims against existing codebase. Post-implementation: verifies implementation consistency against Design Doc (pass `code_paths` scoped to changed files) | Flag discrepancies for document-reviewer |
145
136
  | task-executor | status (escalation_needed/completed), escalation_type, testsAdded, requiresTestReview | On escalation_needed: handle by escalation_type (design_compliance_violation, similar_function_found, similar_component_found, investigation_target_not_found, out_of_scope_file) |
146
137
  | quality-fixer | status (approved/blocked), reason, blockingIssues[], missingPrerequisites[] | On blocked: see quality-fixer blocked handling below |
147
138
  | document-reviewer | approvalReady (true/false) | Proceed to next step on true; request fixes on false |
@@ -182,9 +173,9 @@ According to scale determination:
182
173
  ### Medium Scale (3-5 Files) - 9 Steps (backend) / 11 Steps (frontend/fullstack)
183
174
 
184
175
  1. requirement-analyzer → Requirement analysis **[Stop]**
185
- 2. codebase-analyzerCodebase analysis (pass requirement-analyzer output)
186
- 3. **(frontend/fullstack only)** Ask user for prototype code ui-spec-designer → UI Spec creation
187
- 4. **(frontend/fullstack only)** document-reviewerUI Spec review **[Stop: UI Spec Approval]**
176
+ 2. **(frontend/fullstack only)** Ask user for prototype code → ui-spec-designerUI Spec creation (UI Spec informs component structure for technical design)
177
+ 3. **(frontend/fullstack only)** document-reviewer UI Spec review **[Stop: UI Spec Approval]**
178
+ 4. codebase-analyzerCodebase analysis (pass requirement-analyzer output)
188
179
  5. technical-designer → Design Doc creation (pass codebase-analyzer output as additional context; cross-layer: per layer, see Cross-Layer Orchestration)
189
180
  6. code-verifier → Verify Design Doc against existing code (doc_type: design-doc)
190
181
  7. document-reviewer → Design Doc review (pass code-verifier results as code_verification; cross-layer: per Design Doc)
@@ -327,9 +318,7 @@ Construct the prompt from the agent's Input Parameters section and the deliverab
327
318
  - E2E test file: [path] (execute only in final phase)
328
319
 
329
320
  **On error**: Escalate to user if files are not generated
330
- 3. **Quality Assurance and Commit Execution**: After confirming `status: "approved"`, immediately execute git commit
331
- 4. **Autonomous Execution Mode Management**: Start/stop autonomous execution after approval, escalation decisions
332
- 5. **ADR Status Management**: Update ADR status after user decision (Accepted/Rejected)
321
+ 3. **ADR Status Management**: Update ADR status after user decision (Accepted/Rejected)
333
322
 
334
323
  ## Important Constraints
335
324
 
@@ -339,22 +328,16 @@ Construct the prompt from the agent's Input Parameters section and the deliverab
339
328
  - **Flow confirmation**: After getting approval, ALWAYS check next step with work planning flow (large/medium/small scale)
340
329
  - **Consistency verification**: When subagent outputs conflict, apply Decision precedence (see Delegation Boundary section)
341
330
 
342
- ## Required Dialogue Points with Humans
343
-
344
- ### Basic Principles
345
- - **Stopping is mandatory**: Always wait for human response at the following timings
346
- - **Use AskUserQuestion**: Present confirmations and questions at all Stop points
347
- - **Confirmation -> Agreement cycle**: After document generation, proceed to next step after agreement or fix instructions in update mode
348
- - **Specific questions**: Make decisions easy with options (A/B/C) or comparison tables
349
- - **Dialogue over efficiency**: Get confirmation at early stages to prevent rework
350
-
351
- ### Main Stop Points
352
- - **After requirement-analyzer completion**: Confirm requirement analysis results and questions
353
- - **After PRD creation -> document-reviewer execution**: Confirm requirement understanding and consistency (confirm with question list)
354
- - **After UI Spec creation -> document-reviewer execution** (frontend/fullstack): Confirm UI specification completeness and consistency
355
- - **After ADR creation -> document-reviewer execution**: Confirm technical direction and consistency (present multiple options with comparison table)
356
- - On user approval: Main AI (me) updates Status to Accepted
357
- - On user rejection: Main AI (me) updates Status to Rejected
358
- - **After Design Doc creation -> document-reviewer execution**: Confirm design content and consistency
359
- - **After work plan creation**: Batch approval for entire implementation phase (confirm with plan summary)
331
+ ### Progress Tracking
332
+
333
+ Register overall phases using TaskCreate. Update each phase with TaskUpdate as it completes.
334
+
335
+ ### Post-Implementation Verification Pass/Fail Criteria
336
+
337
+ | Verifier | Pass | Fail | Blocked |
338
+ |----------|------|------|---------|
339
+ | code-verifier | `status` is `consistent` or `mostly_consistent` | `status` is `needs_review` or `inconsistent` | — |
340
+ | security-reviewer | `status` is `approved` or `approved_with_notes` | `status` is `needs_revision` | `status` is `blocked` → Escalate to user |
341
+
342
+ **Re-run rule**: After fix cycle, re-run only verifiers that returned **fail**. Verifiers that passed on the previous run are not re-run. Maximum 2 fix cycles if still failing after 2 cycles, escalate to user with remaining findings.
360
343
 
@@ -168,7 +168,6 @@ skills:
168
168
  - "Agent Coordination Patterns"
169
169
  sections:
170
170
  - "Core Principle: I Am an Orchestrator"
171
- - "Decision Flow When Receiving Tasks"
172
171
  - "Subagents I Can Utilize"
173
172
  - "My Orchestration Principles"
174
173
  - "Constraints Between Subagents"
@@ -179,7 +178,6 @@ skills:
179
178
  - "Autonomous Execution Mode"
180
179
  - "My Main Roles as Orchestrator"
181
180
  - "Important Constraints"
182
- - "Required Dialogue Points with Humans"
183
181
 
184
182
  skill-optimization:
185
183
  skill: "skill-optimization"
@@ -49,12 +49,14 @@ Sources: OWASP Top 10:2025, DryRun Agentic Coding Security Report (2026-03)
49
49
  - 認証ミドルウェアなしで定義されたエンドポイントやルートハンドラ
50
50
  - 認可検証なしのリソースアクセス操作(読み取り、更新、削除)
51
51
  - 昇格された権限なしでアクセス可能な管理操作や破壊的操作
52
- - 最近の研究でこのパターンがAI生成コードで高い発生率を示す高優先度のレビュー対象として扱う
52
+ - AI生成コードでは認証ミドルウェアと認可チェックの欠落が頻発する全ルートハンドラとリソースアクセス操作をレビュー時に明示的に検証対象とする
53
+ - 検出方法: 認証ミドルウェアを持たないルート/エンドポイントハンドラ定義を検索し、呼び出しチェーン内で認可チェックなしのリソース操作(読み取り、更新、削除)を検索
53
54
 
54
55
  ### 例外条件の不適切な処理(OWASP A10:2025)
55
56
  - レスポンスに内部システム詳細(スタックトレース、データベースエラー、ファイルパス)を露出するエラーハンドラ
56
- - フェイルオープン(エラー時にアクセスを許可または検証をスキップ)するエラーハンドラ
57
+ - 例外発生時にアクセスを許可、認証をスキップ、または認可をバイパスするエラーハンドラ(フェイルオープン動作)
57
58
  - セキュリティ上重要な操作(認証、認可、暗号操作)でのエラーハンドリング欠如
59
+ - 検出方法: レスポンスにスタックトレース、データベースエラーメッセージ、ファイルパスを返すcatch/エラーハンドラブロックを検索。セキュリティ状態を再検証せずにnext()を呼び出すまたは成功を返すcatchブロックを検索
58
60
 
59
61
  ### ソフトウェアサプライチェーンパターン(OWASP A03:2025)
60
62
  - バージョン固定なしでインポートされた依存関係
@@ -50,18 +50,14 @@ description: PRD、ADR、Design Doc、作業計画書の作成を支援。技術
50
50
 
51
51
  **含むもの**:
52
52
  - ビジネス要件とユーザー価値
53
- - 成功指標とKPI(測定可能な形式)
53
+ - 成功指標とKPI(各指標に数値目標、測定方法、期間を明記)
54
54
  - ユーザーストーリーとユースケース
55
55
  - MoSCoW法による優先順位(Must/Should/Could/Won't)
56
56
  - MVPとFutureフェーズの分離
57
57
  - ユーザージャーニー図(必須)
58
58
  - スコープ境界図(必須)
59
59
 
60
- **含まないもの**:
61
- - 技術実装詳細(→Design Doc)
62
- - 技術選定理由(→ADR)
63
- - **実装フェーズ**(→作業計画書)
64
- - **タスク分解**(→作業計画書)
60
+ **スコープ**: ビジネス要件、ユーザー価値、成功指標、ユーザーストーリー、優先順位のみ。技術実装詳細はDesign Doc、技術選定理由はADR、フェーズとタスク分解は作業計画書に記載。
65
61
 
66
62
  ### ADR(Architecture Decision Record)
67
63
 
@@ -74,11 +70,7 @@ description: PRD、ADR、Design Doc、作業計画書の作成を支援。技術
74
70
  - アーキテクチャへの影響
75
71
  - 実装への原則的な指針(例:「依存性注入を使用」)
76
72
 
77
- **含まないもの**:
78
- - 実装スケジュール、期間(→作業計画書)
79
- - 実装手順の詳細(→Design Doc)
80
- - 具体的なコード例(→Design Doc)
81
- - 担当者の割り当て(→作業計画書)
73
+ **スコープ**: 決定事項、根拠、選択肢比較、アーキテクチャへの影響、原則的な指針のみ。実装手順とコード例はDesign Doc、スケジュールと担当割り当ては作業計画書に記載。
82
74
 
83
75
  ### UI Spec
84
76
 
@@ -94,11 +86,7 @@ description: PRD、ADR、Design Doc、作業計画書の作成を支援。技術
94
86
  - ビジュアル受入条件(AC)(ゴールデンステート、レイアウト制約)
95
87
  - アクセシビリティ要件(キーボード、スクリーンリーダー、コントラスト)
96
88
 
97
- **含まないもの**:
98
- - 技術実装詳細(→ Design Doc)
99
- - APIコントラクトとデータレイヤー設計(→ Design Doc)
100
- - テスト実装(→ acceptance-test-generatorのスケルトン)
101
- - 実装スケジュール(→ 作業計画書)
89
+ **スコープ**: 画面構造、遷移、コンポーネント分解、インタラクション設計、ビジュアル受入条件のみ。技術実装とAPIコントラクトはDesign Doc、テスト実装はacceptance-test-generatorスケルトン、スケジュールは作業計画書に記載。
102
90
 
103
91
  **必須構造要素**:
104
92
  - 状態×表示マトリクスとインタラクション表を含むコンポーネントが1つ以上
@@ -123,7 +111,7 @@ description: PRD、ADR、Design Doc、作業計画書の作成を支援。技術
123
111
  - **技術的依存関係と実装制約**(実装の必要順序)
124
112
  - インターフェース定義と型定義
125
113
  - データフローとコンポーネント設計
126
- - **受入条件(EARS形式: When/While/If-then/無印)**
114
+ - **受入条件(EARS形式 — design-template.md参照。各条件に検証可能な条件と合否閾値を明記)**
127
115
  - 変更影響マップ(直接影響/間接影響/波及なしを明記)
128
116
  - 統合点の完全な列挙
129
117
  - データ契約の明確化
@@ -152,10 +140,7 @@ description: PRD、ADR、Design Doc、作業計画書の作成を支援。技術
152
140
  互換性確保: [方法]
153
141
  ```
154
142
 
155
- **含まないもの**:
156
- - なぜその技術を選んだか(→ADR参照)
157
- - いつ実装するか、期間(→作業計画書)
158
- - 誰が実装するか(→作業計画書)
143
+ **スコープ**: 技術実装方法、インターフェース、データフロー、受入条件、検証戦略のみ。技術選定理由はADR、スケジュールと担当は作業計画書に記載。
159
144
 
160
145
  ### 作業計画書
161
146
 
@@ -170,29 +155,23 @@ description: PRD、ADR、Design Doc、作業計画書の作成を支援。技術
170
155
  - **最終フェーズに品質保証を含む**(必須)
171
156
  - 進捗記録(チェックボックス形式)
172
157
 
173
- **含まないもの**:
174
- - 技術的な根拠(→ADR)
175
- - 設計の詳細(→Design Doc)
176
- - 技術的依存関係の決定(→Design Doc)
158
+ **スコープ**: タスク分解、依存関係、スケジュール、検証戦略の要約、進捗追跡のみ。技術的な根拠はADR、設計詳細はDesign Docに記載。
177
159
 
178
160
  **フェーズ分割基準**(Design Docの実装アプローチに応じて適用):
179
161
 
180
162
  **垂直スライス選択時**:
181
163
  - 各フェーズ = 1つの価値単位(機能、コンポーネント、移行対象)
182
164
  - 各フェーズに検証戦略に基づく実装+検証を含む
183
- - 最終フェーズ: 品質保証(横断的検証、全テストパス)
184
165
 
185
166
  **水平スライス選択時**:
186
167
  1. **Phase 1: 基盤実装** - 型定義、インターフェース、テスト準備
187
168
  2. **Phase 2: コア機能実装** - ビジネスロジック、ユニットテスト
188
169
  3. **Phase 3: 統合実装** - 外部接続、プレゼンテーション層
189
- 4. **最終Phase: 品質保証(必須)** - 受入条件達成、全テストパス、品質チェック
190
170
 
191
171
  **ハイブリッド選択時**:
192
172
  - Design Docの実装アプローチに基づき垂直と水平を組み合わせる
193
- - 最終フェーズ: 品質保証(必須)
194
173
 
195
- **全アプローチ共通**: 最終フェーズは常に品質保証。各フェーズの検証手法はDesign Docの検証戦略に従う。
174
+ **全アプローチ共通**: 最終フェーズは常に品質保証(受入条件達成、全テストパス、品質チェック)。各フェーズの検証手法はDesign Docの検証戦略に従う。
196
175
 
197
176
  **タスク完了定義の3要素**:
198
177
  1. **実装完了**: コードが動作する
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## ステータス
4
4
 
5
- [Proposed | Accepted | Deprecated | Superseded]
5
+ [Proposed | Accepted | Deprecated | Superseded | Rejected]
6
6
 
7
7
  ## 経緯
8
8
 
@@ -54,6 +54,10 @@
54
54
 
55
55
  - [良くも悪くもない変化をリストアップ]
56
56
 
57
+ ## アーキテクチャへの影響
58
+
59
+ [この決定が既存アーキテクチャにどう影響するか: (1) 変更されるコンポーネント、(2) 新たに導入される依存関係、(3) 追加または撤廃されるアーキテクチャ制約]
60
+
57
61
  ## 実装指針
58
62
 
59
63
  [原則的な方向性のみ。実装手順はDesign Docへ]
@@ -222,11 +222,16 @@ unknowns:
222
222
 
223
223
  ### エラーハンドリング
224
224
 
225
- [エラーの種類とその処理方法]
225
+ | エラーカテゴリ | 例 | 検出方法 | 復旧戦略 | ユーザーへの影響 |
226
+ |-------------|-----|---------|---------|---------------|
227
+ | [検証 / 外部 / インフラ / ビジネスロジック] | [具体的なエラー] | [検出方法] | [リトライ / フォールバック / 伝播 / ログ後続行] | [ユーザー向けメッセージまたはサイレント処理] |
226
228
 
227
229
  ### ロギングとモニタリング
228
230
 
229
- [ログに記録する内容とモニタリング方法]
231
+ - **ログイベント**: [記録すべきイベント: 状態遷移、外部呼び出し、エラー発生、パフォーマンス閾値]
232
+ - **ログレベル**: [DEBUG/INFO/WARN/ERRORの振り分け]
233
+ - **機密データ**: [マスクまたは除外するフィールド — セキュリティ考慮事項と連携]
234
+ - **モニタリング**: [追跡する指標、アラート閾値、ダッシュボード要件]
230
235
 
231
236
  ## 実装計画
232
237
 
@@ -47,7 +47,8 @@
47
47
 
48
48
  Design Docの実装アプローチに基づいてフェーズ構成をひとつ選択する。
49
49
  詳細はdocumentation-criteriaスキルのフェーズ分割基準を参照。
50
- **未使用のOptionは最終計画書から削除すること。** ハイブリッドの場合はOption Aをベースに、必要に応じて水平基盤フェーズを追加する。
50
+ 全品質チェックはcoding-standardsスキルの品質チェックワークフローに従う。
51
+ **未使用のOptionは最終計画書から削除すること。** ハイブリッドの場合はOption Cを使用する。
51
52
 
52
53
  ### Option A: 垂直スライスのフェーズ構成
53
54
 
@@ -60,7 +61,7 @@ Design Docの実装アプローチに基づいてフェーズ構成をひとつ
60
61
  ##### タスク
61
62
  - [ ] タスク1: 実装
62
63
  - [ ] タスク2: 検証戦略に基づく検証
63
- - [ ] 品質チェック: 段階的品質チェック実施(technical-specスキル参照)
64
+ - [ ] 品質チェック(段階的)
64
65
 
65
66
  ##### フェーズ完了条件
66
67
  - [ ] 早期検証ポイント通過
@@ -89,7 +90,7 @@ Design Docの実装アプローチに基づいてフェーズ構成をひとつ
89
90
  ##### タスク
90
91
  - [ ] タスク1: 具体的な作業内容
91
92
  - [ ] タスク2: 具体的な作業内容
92
- - [ ] 品質チェック: 段階的品質チェック実施(technical-specスキル参照)
93
+ - [ ] 品質チェック(段階的)
93
94
  - [ ] 単体テスト: 関連する全テストがパス
94
95
 
95
96
  ##### フェーズ完了条件
@@ -102,7 +103,7 @@ Design Docの実装アプローチに基づいてフェーズ構成をひとつ
102
103
  ##### タスク
103
104
  - [ ] タスク1: 具体的な作業内容
104
105
  - [ ] タスク2: 具体的な作業内容
105
- - [ ] 品質チェック
106
+ - [ ] 品質チェック(段階的)
106
107
  - [ ] 統合テスト: 機能全体の動作確認
107
108
 
108
109
  ##### フェーズ完了条件
@@ -115,13 +116,17 @@ Design Docの実装アプローチに基づいてフェーズ構成をひとつ
115
116
  ##### タスク
116
117
  - [ ] タスク1: 具体的な作業内容
117
118
  - [ ] タスク2: 具体的な作業内容
118
- - [ ] 品質チェック
119
+ - [ ] 品質チェック(段階的)
119
120
  - [ ] 統合テスト: コンポーネント連携の検証
120
121
 
121
122
  ##### フェーズ完了条件
122
123
  - [ ] [機能完了条件]
123
124
  - [ ] [品質完了条件]
124
125
 
126
+ ### Option C: ハイブリッドのフェーズ構成
127
+
128
+ 実装アプローチがハイブリッドの場合に使用。Design Docの実装アプローチに基づき垂直と水平を組み合わせる。各フェーズにタスク、検証、フェーズ完了条件のセクションを上記フォーマットに合わせて記載。
129
+
125
130
  ### 最終Phase: 品質保証(必須)(想定コミット数: 1)
126
131
 
127
132
  このフェーズは全実装アプローチで必須。
@@ -137,7 +142,7 @@ Design Docの実装アプローチに基づいてフェーズ構成をひとつ
137
142
  - [ ] ドキュメント更新
138
143
 
139
144
  ### 品質保証
140
- - [ ] 段階的品質チェック実施(詳細: technical-specスキル参照)
145
+ - [ ] 品質チェック(段階的)
141
146
 
142
147
  ## リスクと対策
143
148
  | リスク | 対策 |
@@ -25,23 +25,45 @@
25
25
  2. [具体的な利用シナリオ2]
26
26
  3. [具体的な利用シナリオ3]
27
27
 
28
+ ### ユーザージャーニー図
29
+ ```mermaid
30
+ journey
31
+ title [機能名] ユーザージャーニー
32
+ section [フェーズ1]
33
+ [ステップ]: [満足度スコア]: [アクター]
34
+ ```
35
+ [トリガーイベントから目標達成までのエンドツーエンドのユーザー体験をマッピング]
36
+
37
+ ### スコープ境界図
38
+ ```mermaid
39
+ C4Context
40
+ Boundary(scope, "スコープ内") {
41
+ [スコープ内のコンポーネント]
42
+ }
43
+ Boundary(out, "スコープ外") {
44
+ [スコープ外のコンポーネント]
45
+ }
46
+ ```
47
+ [この機能に含まれるものと含まれないものを明確化]
48
+
28
49
  ## 機能要件
29
50
 
30
- ### Must HaveMVP
51
+ ### Must Have (P1 - MVP)
31
52
  - [ ] 要件1: [詳細説明]
32
53
  - AC: [受入条件 - Given/When/Then形式または測定可能な基準]
33
54
  - [ ] 要件2: [詳細説明]
34
55
  - AC: [受入条件]
35
- - [ ] 要件3: [詳細説明]
56
+
57
+ ### Should Have (P2)
58
+ - [ ] 要件1: [詳細説明]
36
59
  - AC: [受入条件]
37
60
 
38
- ### Nice to Have
61
+ ### Could Have (P3)
39
62
  - [ ] 要件1: [詳細説明]
40
- - [ ] 要件2: [詳細説明]
41
63
 
42
- ### スコープ外
43
- - 項目1: [説明と理由]
44
- - 項目2: [説明と理由]
64
+ ### Won't Have(今回のリリース対象外)
65
+ - 項目1: [説明と除外理由]
66
+ - 項目2: [説明と除外理由]
45
67
 
46
68
  ## 非機能要件
47
69
 
@@ -69,9 +91,9 @@
69
91
  ## 成功基準
70
92
 
71
93
  ### 定量的指標
72
- 1. [測定可能な成功指標1]
73
- 2. [測定可能な成功指標2]
74
- 3. [測定可能な成功指標3]
94
+ 1. [指標名]: [数値目標] を [測定方法] で [期間] 以内に達成
95
+ 2. [指標名]: [数値目標] を [測定方法] で [期間] 以内に達成
96
+ 3. [指標名]: [数値目標] を [測定方法] で [期間] 以内に達成
75
97
 
76
98
  ### 定性的指標
77
99
  1. [ユーザー体験の指標1]
@@ -38,7 +38,7 @@
38
38
  - **検証手法**: [何をどう検証するか — 例: 「新実装の出力をsrc/legacy/order_calcの既存実装と比較」「エンドポイントをテストDBに対して実行しレスポンスがコントラクトに一致することを確認」]
39
39
  - **成功基準**: [正しさを証明する観察可能な成果 — 例: 「全入力パターンで既存実装と出力が一致」「APIが期待スキーマで200を返す」]
40
40
  - **失敗時の対応**: [検証失敗時の対処 — 例: 「続行前にアプローチを再評価」「ユーザーにエスカレーション」]
41
- - **検証レベル**: [L1/L2/L3、implementation-approachスキル参照]
41
+ - **検証レベル**: [L1: エンドユーザー機能としての動作確認 / L2: 新規テスト追加・パス / L3: ビルドエラーなし]
42
42
 
43
43
  ## 完了条件
44
44
  - [ ] 追加した全テストがパス
@@ -47,4 +47,4 @@
47
47
 
48
48
  ## 備考
49
49
  - 影響範囲: [変更が波及する可能性のある領域]
50
- - 制約: [変更してはいけない領域]
50
+ - スコープ境界: [変更せず維持するファイル — パスと理由]
@@ -20,18 +20,9 @@ description: サブエージェントのタスク分担と連携を調整。規
20
20
  - **分析・設計**: 該当するサブエージェントに委譲
21
21
  - **初動**: ユーザー要件はrequirement-analyzerに渡してから他のステップへ進む
22
22
 
23
- **初動アクション規則**: ユーザー要件を正確に分析するため、requirement-analyzerに直接渡し、その分析結果に基づいてワークフローを決定する。
23
+ ### 初動アクション規則
24
24
 
25
- ## タスク受領時の判断
26
-
27
- ```mermaid
28
- graph TD
29
- Start[新規タスク受領] --> RA[requirement-analyzerで要件分析]
30
- RA --> Scale[規模判定]
31
- Scale --> Flow[規模に応じたフロー実行]
32
- ```
33
-
34
- **フロー実行中は規模判定表に従って次のサブエージェントを決定する**
25
+ 新しいタスクを受け取ったら、ユーザー要件をrequirement-analyzerに直接渡す。その規模判定結果に基づいてワークフローを決定する。
35
26
 
36
27
  ### フロー実行中の要件変更検知
37
28
 
@@ -59,7 +50,7 @@ graph TD
59
50
  10. **technical-designer**: ADR/Design Doc作成(最新技術情報の調査、Property注釈付与)
60
51
  11. **work-planner**: 作業計画書作成(テストスケルトンからメタ情報を抽出・反映)
61
52
  12. **document-reviewer**: 単一ドキュメントの品質・完成度・ルール準拠チェック
62
- 13. **code-verifier**: Design Docの主張を既存コードベースに対して検証(設計フローでレビュー前に使用)
53
+ 13. **code-verifier**: ドキュメントとコードの整合性を検証。実装前: Design Docの主張を既存コードベースに対して検証。実装後: 実装がDesign Docに準拠しているか検証
63
54
  14. **design-sync**: Design Doc間の整合性検証(明示的矛盾のみ検出)
64
55
  15. **acceptance-test-generator**: Design DocのACとUI Spec(任意)から統合テストとE2Eテストのスケルトン生成
65
56
 
@@ -139,7 +130,7 @@ graph TD
139
130
  |-------|---------------|-------------|
140
131
  | requirement-analyzer | scale, confidence, adrRequired, crossLayerScope, scopeDependencies, questions | scaleでフローを選択。adrRequiredでADRステップ要否を判断 |
141
132
  | codebase-analyzer | analysisScope.categoriesDetected, dataModel.detected, focusAreas[], existingElements count, limitations | focusAreasをtechnical-designerにコンテキストとして渡す |
142
- | code-verifier | consistencyScore, discrepancies[], reverseCoverage (dataOperationsInCode, testBoundariesSectionPresent) | discrepanciesをdocument-reviewerに連携 |
133
+ | code-verifier | status (consistent/mostly_consistent/needs_review/inconsistent), consistencyScore, discrepancies[], reverseCoverage (dataOperationsInCode, testBoundariesSectionPresent). 実装前: Design Docの主張を既存コードに対して検証。実装後: 実装のDesign Doc整合性を検証(`code_paths`で変更ファイルにスコープ) | discrepanciesをdocument-reviewerに連携 |
143
134
  | task-executor | status (escalation_needed/completed), escalation_type, testsAdded, requiresTestReview | escalation_needed時: escalation_type別に対応(design_compliance_violation, similar_function_found, similar_component_found, investigation_target_not_found, out_of_scope_file) |
144
135
  | quality-fixer | status (approved/blocked), reason, blockingIssues[], missingPrerequisites[] | blocked時: 下記quality-fixer blockedハンドリング参照 |
145
136
  | document-reviewer | approvalReady (true/false) | trueで次ステップへ。falseで修正を依頼 |
@@ -177,9 +168,9 @@ quality-fixerが `status: "blocked"` を返した場合、`reason`で判別:
177
168
  ### 中規模(3-5ファイル) - 9ステップ(バックエンド) / 11ステップ(フロントエンド/フルスタック)
178
169
 
179
170
  1. requirement-analyzer → 要件分析 **[停止]**
180
- 2. codebase-analyzerコードベース分析(要件分析結果を入力)
181
- 3. **(フロントエンド/フルスタックのみ)** プロトタイプコードの有無を確認ui-spec-designer UI Spec作成
182
- 4. **(フロントエンド/フルスタックのみ)** document-reviewerUI Specレビュー **[停止: UI Spec承認]**
171
+ 2. **(フロントエンド/フルスタックのみ)** プロトタイプコードの有無を確認 → ui-spec-designerUI Spec作成(コンポーネント構造が技術設計に反映されるため先に実施)
172
+ 3. **(フロントエンド/フルスタックのみ)** document-reviewerUI Specレビュー **[停止: UI Spec承認]**
173
+ 4. codebase-analyzerコードベース分析(要件分析結果を入力)
183
174
  5. technical-designer → Design Doc作成(codebase-analyzer出力を追加コンテキストとして入力。レイヤー横断時: レイヤー別に作成、レイヤー横断オーケストレーション参照)
184
175
  6. code-verifier → Design Docを既存コードに対して検証(doc_type: design-doc)
185
176
  7. document-reviewer → Design Docレビュー(code-verifier結果をcode_verificationとして入力。レイヤー横断時: Design Doc毎に実行)
@@ -323,9 +314,7 @@ requirement-analyzerが複数レイヤー(backend + frontend)にまたがる
323
314
  - E2Eテストファイル: [パス](最終フェーズでのみ実行)
324
315
 
325
316
  **エラー時**: ファイルが生成されない場合はユーザーにエスカレーション
326
- 3. **品質保証とコミット実行**: `status: "approved"`確認後、即座にgit commit実行
327
- 4. **自律実行モード管理**: 承認後の自律実行開始・停止・エスカレーション判断
328
- 5. **ADRステータス管理**: ユーザー判断後のADRステータス更新(Accepted/Rejected)
317
+ 3. **ADRステータス管理**: ユーザー判断後のADRステータス更新(Accepted/Rejected)
329
318
 
330
319
  ## 重要な制約
331
320
 
@@ -335,19 +324,15 @@ requirement-analyzerが複数レイヤー(backend + frontend)にまたがる
335
324
  - **フロー確認**: 承認取得後は必ず作業計画フロー(大規模/中規模/小規模)で次のステップを確認
336
325
  - **整合性検証**: サブエージェントの出力が矛盾した場合、優先順位に従って解決(委譲の境界セクション参照)
337
326
 
338
- ## 人間との必須対話ポイント
339
-
340
- ### 基本原則
341
- - **停止は必須**: 以下のタイミングでは必ず人間の応答を待つ
342
- - **AskUserQuestionを使用**: 全ての停止ポイントで確認と質問を提示
343
- - **確認→合意のサイクル**: ドキュメント生成後は合意またはupdateモードでの修正指示を受けてから次へ進む
344
- - **具体的な質問**: 選択肢(A/B/C)や比較表を用いて判断しやすく
345
- - **効率より対話**: 手戻りを防ぐため、早い段階で確認を取る
346
-
347
- ### 主要な停止ポイント
348
- - **requirement-analyzer完了後**: 要件分析結果と質問事項の確認
349
- - **PRD作成→document-reviewer実行後**: 要件理解と整合性の確認
350
- - **UI Spec作成→document-reviewer実行後**(フロントエンド/フルスタック): UI仕様の完全性と整合性の確認
351
- - **ADR作成→document-reviewer実行後**: 技術方針と整合性の確認
352
- - **Design Doc作成→document-reviewer実行後**: 設計内容と整合性の確認
353
- - **計画書作成後**: 実装フェーズ全体の一括承認
327
+ ### 進捗管理
328
+
329
+ TaskCreateで全体フェーズを登録。各フェーズ完了時にTaskUpdateで更新。
330
+
331
+ ### 実装後検証のPass/Fail基準
332
+
333
+ | Verifier | Pass | Fail | Blocked |
334
+ |----------|------|------|---------|
335
+ | code-verifier | `status`が`consistent`または`mostly_consistent` | `status`が`needs_review`または`inconsistent` | — |
336
+ | security-reviewer | `status`が`approved`または`approved_with_notes` | `status`が`needs_revision` | `status`が`blocked` → ユーザーにエスカレーション |
337
+
338
+ **再実行ルール**: 修正サイクル後、**Fail**を返した検証エージェントのみ再実行。前回Passした検証エージェントは再実行しない。最大2回の修正サイクル — 2回後も不合格が残る場合、残存する検出事項とともにユーザーにエスカレーション。
@@ -159,7 +159,6 @@ skills:
159
159
  - "エージェント連携パターン"
160
160
  sections:
161
161
  - "最重要原則:オーケストレーターとして振る舞う"
162
- - "タスク受領時の判断"
163
162
  - "活用できるサブエージェント"
164
163
  - "オーケストレーション原則"
165
164
  - "Sub-agent間の制約"
@@ -170,7 +169,6 @@ skills:
170
169
  - "自律実行モード"
171
170
  - "オーケストレーターの主な役割"
172
171
  - "重要な制約"
173
- - "人間との必須対話ポイント"
174
172
 
175
173
  skill-optimization:
176
174
  skill: "skill-optimization"
package/CHANGELOG.md CHANGED
@@ -5,6 +5,46 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.20.3] - 2026-04-04
9
+
10
+ ### Added
11
+
12
+ - **code-reviewer: Identifier Verification** — Extract identifier specifications (resource names, endpoint paths, config keys, schema names) from Design Doc and verify exact string match against implementation. Added `identifierMatchRate` and `identifierVerification[]` to output schema
13
+ - **code-reviewer: Evidence-Based Confidence** — Multi-source evidence collection (primary: implementation, secondary: tests, tertiary: config/types) with high/medium/low confidence per AC. Added `evidence_source` field to track tool provenance per determination
14
+ - **code-reviewer: Finding Classification** — Quality findings categorized as `dd_violation`/`maintainability`/`reliability`/`coverage_gap` with category-specific rationale requirements. Output Self-Check ensures every finding cites file:line and tool name
15
+ - **Post-Implementation Verification** (commands, skills) — `build` and `front-build` now run code-verifier and security-reviewer in parallel after all tasks complete. Pass/fail criteria defined in orchestration guide with max 2 fix cycles before escalation
16
+ - **front-design: Workflow Overview** — ASCII flow diagram showing the full design pipeline with stop points
17
+ - **front-design: Completion Criteria** — Explicit checklist of required steps before design phase is complete
18
+ - **front-design: design-sync step** — Added Step 4 for cross-document consistency verification before final approval
19
+ - **ADR template: Architecture Impact section** — Documents how the decision affects existing components, dependencies, and constraints
20
+ - **ADR template: Rejected status** — Added to status options alongside Proposed/Accepted/Deprecated/Superseded
21
+ - **PRD template: User Journey and Scope Boundary diagrams** — Required mermaid diagrams added to template
22
+ - **PRD template: MoSCoW prioritization** — Must Have(P1)/Should Have(P2)/Could Have(P3)/Won't Have structure replaces Must/Nice to Have/Out of Scope
23
+ - **PRD template: Quantitative success metrics format** — Each metric specifies numeric target, measurement method, and timeframe
24
+ - **Design template: Error Handling table** — Free-text placeholder replaced with structured table (Category, Example, Detection, Recovery, User Impact)
25
+ - **Design template: Logging sub-categories** — Structured log events, levels, sensitive data handling, and monitoring requirements
26
+ - **Plan template: Hybrid option** — Option C added for hybrid implementation approach alongside Vertical Slice and Horizontal Slice
27
+ - **Security checks: Detection approach** — Added concrete detection methods for Access Control Gaps and Mishandling of Exceptional Conditions patterns
28
+
29
+ ### Changed
30
+
31
+ - **BP-001 Negative → Positive form** (agents, 17 files) — Converted negative instructions to positive directives across all agent definitions. "Don't forget test creation" → "Include test creation in every task", "No contradiction with PRD" → "All requirements align with PRD", "any prohibited" → "use strict types", etc.
32
+ - **BP-002 Vague → Concrete** (agents, skills) — Replaced ambiguous expressions with measurable criteria. "avoid excessive detail" → "include only information required for task execution and verification", "measurable format" → "each metric specifies a numeric target, measurement method, and timeframe"
33
+ - **Emoji markers removed** (agents) — Removed ✅/❌ markers from instruction contexts (quality-fixer, requirement-analyzer, technical-designer-frontend, build, front-build). Retained only in user-facing output templates
34
+ - **documentation-criteria: Excludes → Scope** (skills) — Separate Includes/Excludes blocks consolidated into single Scope statement per document type, reducing duplication
35
+ - **documentation-criteria: QA phase unified** (skills) — Per-approach "Final Phase: Quality Assurance" entries consolidated into single "All approaches" statement
36
+ - **orchestration-guide: First Action Rule simplified** (skills) — Mermaid diagram and duplicate text replaced with single-line rule
37
+ - **orchestration-guide: Redundant sections removed** (skills) — Required Dialogue Points, Decision Flow diagram, duplicate orchestrator roles compressed
38
+ - **orchestration-guide: Medium frontend flow reordered** (skills) — UI Spec creation moved before codebase analysis to match large-scale flow and front-design command — component structure informs technical design
39
+ - **orchestration-guide: code-verifier description expanded** (skills) — Now documents both pre-implementation and post-implementation verification modes with status field values
40
+ - **front-design: Execution Protocol** (commands) — Replaced role/method block with structured protocol referencing orchestration guide. Documents UI Spec → codebase-analyzer ordering rationale
41
+ - **front-plan: Test skeleton mandatory** (commands) — Removed optional user confirmation — acceptance-test-generator always executes before work-planner per orchestration guide flow
42
+ - **front-build: Streamlined** (commands) — Removed redundant Execution Method, Sub-agent Invocation Method, and Structured Response Specification sections. Scope line added to Execution Protocol
43
+ - **front-review: Orchestrator identity** (commands) — Added Orchestrator Definition with TaskCreate-first action. Replaced rule-advisor with documentation-criteria in fix flow. Step numbering unified (Step 1-11)
44
+ - **review/front-review: Re-validation context** (commands) — Re-validation prompts now include Design Doc path and implementation file list alongside prior issues
45
+ - **review/front-review: Report template** (commands) — Added identifierMatchRate, confidence levels, identifier mismatches, and quality findings sections
46
+ - **skills-index.yaml** (skills) — Removed deleted sections from orchestration-guide entry (Decision Flow, Required Dialogue Points)
47
+
8
48
  ## [1.20.2] - 2026-04-03
9
49
 
10
50
  ### Added