create-ai-project 1.20.4 → 1.20.5

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

@@ -45,10 +45,26 @@ Choose Strategy A (TDD) if test skeletons are provided, Strategy B (implementati
 
 **Phase structure**: Select based on implementation approach from Design Doc. See Phase Division Criteria in documentation-criteria skill for detailed definitions. Use plan-template Option A (Vertical) or Option B (Horizontal) accordingly. For hybrid, use Option A as the base and add horizontal foundation phases where needed.
 
-### 5. Define Tasks with Completion Criteria
+### 5. Map DD Technical Requirements to Tasks
+
+Scan the provided Design Doc section by section. Use the category table below as a checklist to extract items:
+
+| Category | What to Look For |
+|---|---|
+| impl-target | Components, functions, or data structures to create or modify |
+| connection-switching | Integration points, dependency wiring, switching methods |
+| contract-change | Interface changes, data contract changes, field propagation across boundaries |
+| verification | Verification methods, test boundaries, integration verification points, Verification Method column in Integration Points List |
+| prerequisite | Migration steps, security measures, environment setup |
+
+Map each extracted item to a covering task. Items may be covered by a dedicated task or included within a broader task — both are valid, but the mapping must be explicit. Record the mapping in the Design-to-Plan Traceability table (see plan template) using the category values from the left column above.
+
+If an item has no covering task, set Gap Status to `gap` with justification in Notes. **When the Traceability table contains any `gap` entry, the plan is in draft status.** Output the plan as draft, but do not finalize it until the user has confirmed each justified gap. Unjustified gaps (no Notes) are errors — add a covering task or provide justification before proceeding.
+
+### 6. Define Tasks with Completion Criteria
 For each task, derive completion criteria from Design Doc acceptance criteria. Apply the 3-element completion definition (Implementation Complete, Quality Complete, Integration Complete).
 
-### 6. Produce Work Plan Document
+### 7. Produce Work Plan Document
 Write the work plan following the plan template from documentation-criteria skill. Include Phase Structure Diagram and Task Dependency Diagram (mermaid).
 
 ## Input Parameters
@@ -73,7 +89,7 @@ Write the work plan following the plan template from documentation-criteria skil
 3. **Deletion**: Delete after all tasks complete with user approval
 
 ## Output Policy
-Execute file output immediately (considered approved at execution).
+Execute file output immediately (considered approved at execution). **Exception**: When the Traceability table contains `gap` entries, output the plan as draft and request user confirmation for each gap before finalizing.
 
 ## Important Task Design Principles
 
@@ -221,6 +237,9 @@ When creating work plans, **Phase Structure Diagrams** and **Task Dependency Dia
 ## Quality Checklist
 
 - [ ] Design Doc(s) consistency verification
+- [ ] Design-to-Plan Traceability table complete (all DD technical requirements categorized and mapped)
+  - [ ] No `gap` entries without justification
+  - [ ] All justified `gap` entries flagged for user confirmation before plan approval
 - [ ] Verification Strategy extracted from Design Doc and included in plan header
 - [ ] Phase structure matches implementation approach (vertical → value unit phases, horizontal → layer phases)
 - [ ] Early verification point placed in Phase 1 (when Verification Strategy specifies one)

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

@@ -45,10 +45,26 @@ Design Doc、UI Spec、PRD、ADR（提供されている場合）を読み込み
 
 **フェーズ構成**: Design Docの実装アプローチに基づいて選択。詳細はdocumentation-criteriaスキルのフェーズ分割基準を参照。plan-templateのOption A（垂直）またはOption B（水平）に従う。ハイブリッドの場合はOption Aをベースに、必要に応じて水平基盤フェーズを追加する。
 
-### 5. 完了条件付きタスクの定義
+### 5. DD技術要件のタスクへのマッピング
+
+提供されたDesign Docをセクションごとにスキャンする。以下のカテゴリテーブルをチェックリストとして、該当する項目を抽出する:
+
+| カテゴリ | 抽出対象 |
+|---|---|
+| impl-target | 作成・変更が必要なコンポーネント、関数、データ構造 |
+| connection-switching | 統合ポイント、依存関係の配線、切替方式 |
+| contract-change | インターフェース変更、データコントラクト変更、境界を越えるフィールドの伝搬 |
+| verification | 検証手法、テスト境界、統合検証ポイント、統合ポイント一覧の検証方式列 |
+| prerequisite | マイグレーション手順、セキュリティ対策、環境セットアップ |
+
+抽出した各項目をカバーするタスクにマッピングする。専用タスクでカバーしても、より包括的なタスクに内包してもよいが、マッピングは必ず明示すること。マッピング結果は計画テンプレートの設計-計画トレーサビリティ表に、上記左列のカテゴリ値を使用して記録する。
+
+カバーするタスクがない項目はギャップステータスを`gap`とし、備考に理由を記載する。**トレーサビリティ表に`gap`が1件でも含まれる場合、計画書はドラフト状態とする。** ドラフトとして出力するが、ユーザーが各ギャップを確認するまで確定しない。理由なしのギャップ（備考が空）はエラーとして扱い、カバーするタスクを追加するか理由を記載してから進める。
+
+### 6. 完了条件付きタスクの定義
 各タスクについて、Design Docの受入条件から完了条件を導出。3要素の完了定義（実装完了、品質完了、統合完了）を適用。
 
-### 6. 作業計画書の作成
+### 7. 作業計画書の作成
 documentation-criteriaスキルの計画テンプレートに従って作業計画書を記述。フェーズ構成図とタスク依存関係図（mermaid）を含める。
 
 ## Input Parameters
@@ -72,7 +88,7 @@ documentation-criteriaスキルの計画テンプレートに従って作業計
 2. **更新**: 各フェーズ完了時に進捗更新（チェックボックス）
 3. **削除**: 全タスク完了後、ユーザー承認を得て削除
 ## 出力方針
-ファイル出力は即座に実行（実行時点で承認済み）。
+ファイル出力は即座に実行（実行時点で承認済み）。**例外**: トレーサビリティ表に`gap`が含まれる場合は、計画書をドラフトとして出力し、各ギャップについてユーザー確認を得てから確定する。
 
 ## タスク設計の重要原則
 
@@ -220,6 +236,9 @@ Design Docの技術的依存関係と実装アプローチに基づいてフェ
 ## 品質チェックリスト
 
 - [ ] Design Doc（複数時は各Doc）の整合性確認
+- [ ] 設計-計画トレーサビリティ表の完成（DDの全技術要件がカテゴリ分類・マッピング済み）
+  - [ ] 理由なしの`gap`がないこと
+  - [ ] 理由ありの`gap`は計画承認前にユーザー確認を実施
 - [ ] Design Docから検証戦略を抽出し計画書ヘッダーに記載
 - [ ] フェーズ構成が実装アプローチと整合（垂直 → 価値単位フェーズ、水平 → レイヤーフェーズ）
 - [ ] 早期検証ポイントをPhase 1に配置（検証戦略で指定されている場合）

package/.claude/skills-en/documentation-criteria/references/design-template.md

@@ -120,6 +120,12 @@ No Ripple Effect:
   - [Explicitly specify unaffected features]
 ```
 
+### Interface Change Matrix
+
+| Existing | New | Conversion Required | Compatibility Method |
+|----------|-----|--------------------|--------------------|
+| [Function/method/operation name] | [Function/method/operation name] | [Yes/No] | [Approach: adapter, wrapper, deprecation, etc.] |
+
 ### Architecture Overview
 
 [How this feature is positioned within the overall system]
@@ -132,10 +138,10 @@ No Ripple Effect:
 
 ### Integration Points List
 
-| Integration Point | Location | Old Implementation | New Implementation | Switching Method |
-|-------------------|----------|-------------------|-------------------|------------------|
-| Integration Point 1 | [Class/Function] | [Existing Process] | [New Process] | [DI/Factory etc.] |
-| Integration Point 2 | [Another Location] | [Existing] | [New] | [Method] |
+| Integration Point | Location | Old Implementation | New Implementation | Switching Method | Verification Method |
+|-------------------|----------|-------------------|-------------------|------------------|-------------------|
+| Integration Point 1 | [Class/Function] | [Existing Process] | [New Process] | [DI/Factory etc.] | [How to verify this switching works] |
+| Integration Point 2 | [Another Location] | [Existing] | [New] | [Method] | [Verification approach] |
 
 ### Main Components
 

package/.claude/skills-en/documentation-criteria/references/plan-template.md

@@ -24,6 +24,19 @@ Related Issue/PR: #XXX (if any)
 - **Success criteria**: [extracted from Design Doc]
 - **Failure response**: [extracted from Design Doc]
 
+## Design-to-Plan Traceability
+
+Maps each Design Doc technical requirement to the covering task(s). One row per extracted item. Every row must have at least one covering task, or an explicit gap justification.
+
+| DD Section | DD Item | Category | Covered By Task(s) | Gap Status | Notes |
+|---|---|---|---|---|---|
+| [Section name from DD] | [Specific item] | impl-target / connection-switching / contract-change / verification / prerequisite | [Phase X Task Y] | covered | |
+| Security Considerations | Input validation for API | prerequisite | — | gap | Deferred to Phase 2 per user decision |
+
+**Category values**: `impl-target` (implementation target), `connection-switching` (connection/switching/registration), `contract-change` (contract change and propagation), `verification` (verification requirement), `prerequisite` (prerequisite work)
+
+**Gap Status values**: `covered` (task exists), `gap` (no task — requires justification in Notes, user confirmation required before plan approval)
+
 ## Objective
 [Why this change is necessary, what problem it solves]
 

package/.claude/skills-en/subagents-orchestration-guide/SKILL.md

@@ -301,7 +301,13 @@ Construct the prompt from the agent's Input Parameters section and the deliverab
 
    #### technical-designer → work-planner
 
-   **Pass to work-planner**: Design Doc path. Work-planner extracts Verification Strategy from the Design Doc and includes it in the work plan header.
+   **Pass to work-planner**: Design Doc path. Work-planner scans all DD sections and extracts technical requirements per its Step 5 categories (impl-target, connection-switching, contract-change, verification, prerequisite), then produces a Design-to-Plan Traceability table.
+
+   **Gap handling (orchestrator responsibility)**: If work-planner outputs a draft plan containing `gap` entries, the orchestrator MUST:
+   1. Present the gap entries to the user with justifications
+   2. Keep the plan in draft status until the user confirms each gap
+   3. Do NOT pass the plan to downstream agents (task-decomposer, etc.) until all gaps are resolved or confirmed
+   Unjustified gaps are errors — return to work-planner to add covering tasks or justification.
 
    #### *1 acceptance-test-generator → work-planner
 

package/.claude/skills-ja/documentation-criteria/references/design-template.md

@@ -120,6 +120,12 @@ unknowns:
   - [明示的に影響を受けない機能]
 ```
 
+### インターフェース変更マトリクス
+
+| 既存 | 新規 | 変換要否 | 互換方式 |
+|------|------|---------|---------|
+| [関数/メソッド/操作名] | [関数/メソッド/操作名] | [Yes/No] | [手法: adapter, wrapper, deprecation等] |
+
 ### アーキテクチャ概要
 
 [この機能がシステム全体の中でどのように位置づけられるか]
@@ -132,10 +138,10 @@ unknowns:
 
 ### 統合ポイント一覧
 
-| 統合ポイント | 箇所 | 旧実装 | 新実装 | 切替方式 |
-|------------|-----|-------|-------|---------|
-| 統合ポイント1 | [クラス/関数] | [既存処理] | [新処理] | [DI/Factoryなど] |
-| 統合ポイント2 | [別の箇所] | [既存] | [新規] | [方式] |
+| 統合ポイント | 箇所 | 旧実装 | 新実装 | 切替方式 | 検証方式 |
+|------------|-----|-------|-------|---------|---------|
+| 統合ポイント1 | [クラス/関数] | [既存処理] | [新処理] | [DI/Factoryなど] | [この切替が動作することの検証方法] |
+| 統合ポイント2 | [別の箇所] | [既存] | [新規] | [方式] | [検証方法] |
 
 ### 主要コンポーネント
 

package/.claude/skills-ja/documentation-criteria/references/plan-template.md

@@ -24,6 +24,19 @@
 - **成功基準**: [Design Docから抽出]
 - **失敗時の対応**: [Design Docから抽出]
 
+## 設計-計画トレーサビリティ
+
+Design Docの各技術要件をカバーするタスクへのマッピング。抽出した項目ごとに1行。各行には対応タスクが少なくとも1つ必要。タスクがない場合は明示的なギャップ理由が必要。
+
+| DDセクション | DD項目 | カテゴリ | カバーするタスク | ギャップステータス | 備考 |
+|---|---|---|---|---|---|
+| [DDのセクション名] | [具体的な項目] | impl-target / connection-switching / contract-change / verification / prerequisite | [Phase X タスクY] | covered | |
+| セキュリティ考慮事項 | APIの入力バリデーション | prerequisite | — | gap | ユーザー判断によりPhase 2に延期 |
+
+**カテゴリ値**: `impl-target`（実装対象）、`connection-switching`（接続/切替/登録）、`contract-change`（コントラクト変更と伝搬）、`verification`（検証要件）、`prerequisite`（前提作業）
+
+**ギャップステータス値**: `covered`（タスクあり）、`gap`（タスクなし — 備考に理由必須、計画承認前にユーザー確認が必要）
+
 ## 目的
 [なぜこの変更が必要か、何を解決するか]
 

package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md

@@ -297,7 +297,13 @@ requirement-analyzerが複数レイヤー（backend + frontend）にまたがる
 
    #### technical-designer → work-planner
 
-   **work-plannerへの入力**: Design Docパス。work-plannerがDesign Docから検証戦略を抽出し、作業計画書ヘッダーに記載する。
+   **work-plannerへの入力**: Design Docパス。work-plannerがDDの全セクションをスキャンし、Step 5のカテゴリ（impl-target, connection-switching, contract-change, verification, prerequisite）に沿って技術要件を抽出した上で、設計-計画トレーサビリティ表を作成する。
+
+   **ギャップ発生時の制御（オーケストレーターの責務）**: work-plannerが`gap`を含むドラフト計画書を出力した場合、オーケストレーターは以下を実行する:
+   1. ギャップ項目と理由をユーザーに提示する
+   2. ユーザーが各ギャップを確認するまで計画書をドラフト状態に保つ
+   3. 全ギャップの解消または確認が完了するまで、後続エージェント（task-decomposer等）に計画書を渡さない
+   理由なしのギャップはエラーとして扱い、work-plannerに差し戻してカバーするタスクの追加または理由の記載を求める。
 
    #### *1 acceptance-test-generator → work-planner
 

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.20.5] - 2026-04-06
+
+### Added
+
+- **work-planner: Design-to-Plan Traceability** (agents) — New Step 5 scans all DD sections and extracts technical requirements into five categories (impl-target, connection-switching, contract-change, verification, prerequisite). Each item is mapped to a covering task in a Traceability table. Items without a covering task are marked as `gap` with mandatory justification; the plan remains in draft status until all gaps are user-confirmed
+- **plan-template: Design-to-Plan Traceability section** (skills) — Traceability table template with sample rows for both `covered` and `gap` entries, category value definitions, and gap status definitions
+- **design-template: Interface Change Matrix** (skills) — New section after Change Impact Map documenting existing-to-new interface mappings with conversion requirements and compatibility methods
+- **design-template: Verification Method column** (skills) — Integration Points List expanded with Verification Method column to explicitly capture how each switching point is verified
+- **orchestration-guide: Gap handling for work-planner handoff** (skills) — Orchestrator must present gap entries to user, keep plan in draft until confirmed, and block downstream agents (task-decomposer, etc.) until all gaps are resolved. Unjustified gaps are errors returned to work-planner
+
+### Changed
+
+- **work-planner: Output Policy gap exception** (agents) — Added explicit exception to the immediate-output policy: plans containing `gap` entries are output as draft and require user confirmation before finalizing
+- **work-planner: Category table simplified** (agents) — Removed Task Requirement column (redundant with Traceability table's Category column). Category values now use short codes (impl-target, etc.) matching the Traceability table directly
+- **orchestration-guide: technical-designer → work-planner handoff deduplicated** (skills) — Replaced inline category descriptions with reference to work-planner Step 5, establishing work-planner as single source of truth for category definitions
+
 ## [1.20.4] - 2026-04-05
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ai-project",
-  "version": "1.20.4",
+  "version": "1.20.5",
   "packageManager": "npm@10.8.2",
   "description": "TypeScript boilerplate with skills and sub-agents for Claude Code. Prevents context exhaustion through role-based task splitting.",
   "keywords": [