create-ai-project 1.23.3 → 1.23.4

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 (34) hide show
  1. package/.claude/agents-en/acceptance-test-generator.md +2 -1
  2. package/.claude/agents-en/quality-fixer-frontend.md +3 -3
  3. package/.claude/agents-en/quality-fixer.md +3 -3
  4. package/.claude/agents-en/task-decomposer.md +2 -1
  5. package/.claude/agents-en/task-executor-frontend.md +1 -1
  6. package/.claude/agents-en/task-executor.md +1 -1
  7. package/.claude/agents-en/work-planner.md +2 -5
  8. package/.claude/agents-ja/acceptance-test-generator.md +2 -1
  9. package/.claude/agents-ja/quality-fixer-frontend.md +3 -3
  10. package/.claude/agents-ja/quality-fixer.md +3 -3
  11. package/.claude/agents-ja/task-decomposer.md +2 -1
  12. package/.claude/agents-ja/task-executor-frontend.md +1 -1
  13. package/.claude/agents-ja/task-executor.md +1 -1
  14. package/.claude/agents-ja/work-planner.md +2 -5
  15. package/.claude/commands-en/build.md +6 -15
  16. package/.claude/commands-en/front-build.md +4 -13
  17. package/.claude/commands-en/implement.md +2 -15
  18. package/.claude/commands-en/plan.md +7 -2
  19. package/.claude/commands-en/prepare-implementation.md +7 -17
  20. package/.claude/commands-en/sync-skills.md +3 -3
  21. package/.claude/commands-ja/build.md +7 -16
  22. package/.claude/commands-ja/front-build.md +4 -13
  23. package/.claude/commands-ja/implement.md +2 -15
  24. package/.claude/commands-ja/plan.md +6 -1
  25. package/.claude/commands-ja/prepare-implementation.md +8 -18
  26. package/.claude/commands-ja/sync-skills.md +3 -3
  27. package/.claude/skills-en/documentation-criteria/references/plan-template.md +0 -2
  28. package/.claude/skills-en/integration-e2e-testing/SKILL.md +2 -0
  29. package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +2 -7
  30. package/.claude/skills-ja/documentation-criteria/references/plan-template.md +0 -2
  31. package/.claude/skills-ja/integration-e2e-testing/SKILL.md +2 -0
  32. package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +2 -7
  33. package/CHANGELOG.md +8 -0
  34. package/package.json +1 -1
@@ -332,7 +332,8 @@ Upon completion, report in the following JSON format. Detailed meta information
332
332
 
333
333
  **Required Compliance**:
334
334
  - Output `it.todo` skeletons only: each skeleton contains verification points, expected results, pass criteria, primary failure mode, and proof obligation as comments inside `it.todo` blocks.
335
- Implementation code, assertions (`expect`), and mock setup must not be includeddownstream consumers parse `it.todo` presence to determine phase placement and review status.
335
+ Import only the test-framework symbols the `it.todo` needs (e.g. `describe`/`it`); the implementing task adds application-module imports, assertions (`expect`), and mock setup alongside the implementation (Red→Green within one task/commit). Keep the module under test out of the skeleton's imports because it may not exist yeta committed skeleton that references not-yet-implemented code can fail gates that type-check, compile, or load test files before implementation begins (e.g. TypeScript projects may report TS2307).
336
+ Downstream consumers parse `it.todo` presence to determine phase placement and review status.
336
337
  - Clearly state verification points, expected results, and pass criteria for each test
337
338
  - Preserve original AC statements in comments (ensure traceability)
338
339
  - Stay within budget; report to user if budget insufficient for critical tests
@@ -241,10 +241,10 @@ Minimal example (`blocked` — Variant B, missing prerequisites):
241
241
  During execution, report progress between tool calls using this format:
242
242
 
243
243
  ```markdown
244
- 📋 Phase [Number]: [Phase Name]
244
+ Phase [Number]: [Phase Name]
245
245
 
246
246
  Executed Command: [Command]
247
- Result: Errors [Count] / ⚠️ Warnings [Count] / Pass
247
+ Result: Errors [Count] / Warnings [Count] / Pass
248
248
 
249
249
  Issues requiring fixes:
250
250
  1. [Issue Summary]
@@ -253,7 +253,7 @@ Issues requiring fixes:
253
253
  - Fix Method: [Specific Fix Approach]
254
254
 
255
255
  [After Fix Implementation]
256
- Phase [Number] Complete! Proceeding to next phase.
256
+ Phase [Number] Complete! Proceeding to next phase.
257
257
  ```
258
258
 
259
259
  This is intermediate output only. The final response must be the JSON result (Step 6).
@@ -205,10 +205,10 @@ Minimal example (`blocked` — Variant B, missing prerequisites):
205
205
  During execution, report progress between tool calls using this format:
206
206
 
207
207
  ```markdown
208
- 📋 Phase [Number]: [Phase Name]
208
+ Phase [Number]: [Phase Name]
209
209
 
210
210
  Executed Command: [Command]
211
- Result: Errors [Count] / ⚠️ Warnings [Count] / Pass
211
+ Result: Errors [Count] / Warnings [Count] / Pass
212
212
 
213
213
  Issues requiring fixes:
214
214
  1. [Issue Summary]
@@ -217,7 +217,7 @@ Issues requiring fixes:
217
217
  - Fix Method: [Specific Fix Approach]
218
218
 
219
219
  [After Fix Implementation]
220
- Phase [Number] Complete! Proceeding to next phase.
220
+ Phase [Number] Complete! Proceeding to next phase.
221
221
  ```
222
222
 
223
223
  This is intermediate output only. The final response must be the JSON result (Step 6).
@@ -65,6 +65,7 @@ Decompose tasks based on implementation strategy patterns determined in implemen
65
65
  2. **Plan Analysis and Overall Design**
66
66
  - Confirm phase structure
67
67
  - Extract task list
68
+ - Skip any task already checked off (`[x]`) and annotated as committed (e.g. a Phase 0 resolved by the prepare-implementation recipe) — its work is already in the codebase. Generate task files only for outstanding (`[ ]`) tasks so completed work is not regenerated or re-executed
68
69
  - Identify dependencies
69
70
  - **Overall Optimization Considerations**
70
71
  - Identify common processing (prevent redundant implementation)
@@ -287,7 +288,7 @@ Task 3: [Content]
287
288
  ### Decomposition Completion Report
288
289
 
289
290
  ```markdown
290
- 📋 Task Decomposition Complete
291
+ Task Decomposition Complete
291
292
 
292
293
  Plan Document: [Filename]
293
294
  Overall Design Document: _overview-[plan-name].md
@@ -116,7 +116,7 @@ Internal detail optimization (variable names, logic order); specs not in Design
116
116
 
117
117
  ## Responsibilities, Authority, and Boundaries
118
118
 
119
- **In scope**: Read task files from `docs/plans/tasks/`, review dependency deliverables listed in task "Metadata", create React function components and React Testing Library tests, co-locate tests with components, apply Red→Green→Refactor TDD, update progress checkboxes (task file always; work plan and overall design only when those files exist — at small scale only the task file exists), produce research deliverables specified in `Provides`. State transitions: `[ ]` → `[🔄]` → `[x]`.
119
+ **In scope**: Read task files from `docs/plans/tasks/`, review dependency deliverables listed in task "Metadata", create React function components and React Testing Library tests, co-locate tests with components, apply Red→Green→Refactor TDD, update progress checkboxes (task file always; work plan and overall design only when those files exist — at small scale only the task file exists), produce research deliverables specified in `Provides`. State transitions: `[ ]` → `[x]`.
120
120
 
121
121
  **Out of scope (always)**: Overall quality checks (delegated to quality assurance), commit creation (after quality checks), forcing implementation when Design Doc cannot be satisfied (always escalate), class components (deprecated in modern React).
122
122
 
@@ -116,7 +116,7 @@ Internal detail optimization (variable names, processing order); specs not in De
116
116
 
117
117
  ## Responsibilities, Authority, and Boundaries
118
118
 
119
- **In scope**: Read task files from `docs/plans/tasks/`, review dependency deliverables listed in task "Metadata", create implementation and tests, apply Red→Green→Refactor TDD, update progress checkboxes (task file always; work plan and overall design only when those files exist — at small scale only the task file exists), produce research deliverables specified in `Provides`. State transitions: `[ ]` → `[🔄]` → `[x]`.
119
+ **In scope**: Read task files from `docs/plans/tasks/`, review dependency deliverables listed in task "Metadata", create implementation and tests, apply Red→Green→Refactor TDD, update progress checkboxes (task file always; work plan and overall design only when those files exist — at small scale only the task file exists), produce research deliverables specified in `Provides`. State transitions: `[ ]` → `[x]`.
120
120
 
121
121
  **Out of scope (always)**: Overall quality checks (delegated to quality assurance), commit creation (after quality checks), forcing implementation when Design Doc cannot be satisfied (always escalate).
122
122
 
@@ -55,7 +55,7 @@ fixture-e2e gap:
55
55
  AND e2eAbsenceReason.fixtureE2e was not communicated
56
56
  AND Design Doc or UI Spec contains user-facing multi-step user journey
57
57
  THEN add to work plan header:
58
- fixture-e2e Gap: This feature contains user-facing multi-step journey(s)
58
+ fixture-e2e Gap: This feature contains user-facing multi-step journey(s)
59
59
  but no fixture-e2e skeleton was provided. Route this feature back through
60
60
  acceptance-test generation to evaluate fixture-e2e candidates before the
61
61
  UI implementation phase.
@@ -68,7 +68,7 @@ service-integration-e2e gap:
68
68
  verification (data persistence across services, transactional
69
69
  consistency, external service contract)
70
70
  THEN add to work plan header:
71
- service-integration-e2e Gap: This feature crosses service boundaries
71
+ service-integration-e2e Gap: This feature crosses service boundaries
72
72
  where correctness depends on real cross-service behavior, but no
73
73
  service-integration-e2e skeleton was provided.
74
74
  Detected boundaries: [list crossings and AC references]
@@ -159,8 +159,6 @@ For each task, derive completion criteria from Design Doc acceptance criteria. A
159
159
  - **`scale: medium` / `scale: large`**: Write a work plan following the **plan-template** from documentation-criteria skill. Include Phase Structure Diagram and Task Dependency Diagram (mermaid).
160
160
  - **`scale: small`**: Write a single task file following the **task-template** from documentation-criteria skill (see "Output Mode by Scale" below). Skip Phase Structure / Task Dependency diagrams; the task file's `## Implementation Steps` section drives execution.
161
161
 
162
- For `scale: medium` / `scale: large`, the plan header MUST include the line `Implementation Readiness: pending`. The marker contract: it takes one of three values — `pending` (initial, set here by work-planner), `ready` (verification completed with no remaining gaps), or `escalated` (verification completed with remaining gaps). The producer that promotes the marker beyond `pending` and the consumer that reads it before execution are external orchestration concerns owned outside this agent.
163
-
164
162
  ## Input Parameters
165
163
 
166
164
  - **mode**: `create` (default) | `update`
@@ -365,7 +363,6 @@ When creating work plans, **Phase Structure Diagrams** and **Task Dependency Dia
365
363
  - [ ] Each row's `Axis` value is exactly one of `placement` | `dependency_direction` | `contract_schema` | `data_flow` | `persistence`
366
364
  - [ ] Each row's `Source Section` is set to `Decision` or `Implementation Guidance` matching the actual location of the decision in the ADR
367
365
  - [ ] Every row maps to at least one covering task
368
- - [ ] Plan header includes `Implementation Readiness: pending` (medium / large only)
369
366
  - [ ] Verification Strategy extracted from Design Doc and included in plan header
370
367
  - [ ] Proof Strategy included in plan header (proof obligation source + per-task propagation rule)
371
368
  - [ ] Review Scope recorded in plan header (base branch / diff range / changed-files scope)
@@ -334,7 +334,8 @@ it.todo('[AC番号]-property: [不変条件を自然言語で記述]')
334
334
 
335
335
  **必須準拠事項**:
336
336
  - `it.todo`スケルトンのみ出力: 各スケルトン内にコメントとして検証観点、期待結果、合格基準、主要な故障モード、証明義務を記述。
337
- 実装コード、アサーション(`expect`)、モックセットアップは含めない下流の処理で`it.todo`の有無によりフェーズ配置やレビュー判定が行われる。
337
+ `it.todo` が必要とするテストフレームワークのシンボル(`describe`/`it` など)のみを import する。アプリケーション側モジュールの import、アサーション(`expect`)、モックセットアップは、実装と同じタスク/コミットで実装時に追加する(Red→Green を1コミット内に収める)。テスト対象モジュールはまだ存在しない可能性があるため、スケルトンの import には含めない 未実装コードを参照するスケルトンをコミットすると、テストファイルを型チェック・コンパイル・ロードするゲートが実装着手前に失敗し得る(例: TypeScript では TS2307 が報告され得る)。
338
+ 下流の処理では`it.todo`の有無によりフェーズ配置やレビュー判定が行われる。
338
339
  - 各テストの検証観点、期待結果、合格基準を明確に記述
339
340
  - コメントに元のAC文を保持(トレーサビリティ確保)
340
341
  - テスト上限設定内に収める;重要テストに上限超過の場合は報告
@@ -241,10 +241,10 @@ package.json からフロントエンドビルドコマンドを自動検出し
241
241
  実行中、ツール呼び出しの間に以下のフォーマットで進捗を報告する:
242
242
 
243
243
  ```markdown
244
- 📋 Phase [番号]: [フェーズ名]
244
+ Phase [番号]: [フェーズ名]
245
245
 
246
246
  実行コマンド: [コマンド]
247
- 結果: エラー [件数] / ⚠️ 警告 [件数] / パス
247
+ 結果: エラー [件数] / 警告 [件数] / パス
248
248
 
249
249
  修正が必要な問題:
250
250
  1. [問題概要]
@@ -253,7 +253,7 @@ package.json からフロントエンドビルドコマンドを自動検出し
253
253
  - 修正方法: [具体的な修正アプローチ]
254
254
 
255
255
  [修正実施後]
256
- Phase [番号] 完了!次のフェーズへ進みます。
256
+ Phase [番号] 完了!次のフェーズへ進みます。
257
257
  ```
258
258
 
259
259
  これは中間出力であり、最終レスポンスはJSON結果(ステップ6)で出力する。
@@ -205,10 +205,10 @@ coding-standardsおよびtypescript-testingスキルに従って修正を適用
205
205
  実行中、ツール呼び出しの間に以下のフォーマットで進捗を報告する:
206
206
 
207
207
  ```markdown
208
- 📋 Phase [番号]: [フェーズ名]
208
+ Phase [番号]: [フェーズ名]
209
209
 
210
210
  実行コマンド: [コマンド]
211
- 結果: エラー [件数] / ⚠️ 警告 [件数] / パス
211
+ 結果: エラー [件数] / 警告 [件数] / パス
212
212
 
213
213
  修正が必要な問題:
214
214
  1. [問題概要]
@@ -217,7 +217,7 @@ coding-standardsおよびtypescript-testingスキルに従って修正を適用
217
217
  - 修正方法: [具体的な修正アプローチ]
218
218
 
219
219
  [修正実施後]
220
- Phase [番号] 完了!次のフェーズへ進みます。
220
+ Phase [番号] 完了!次のフェーズへ進みます。
221
221
  ```
222
222
 
223
223
  これは中間出力であり、最終レスポンスはJSON結果(ステップ6)で出力する。
@@ -65,6 +65,7 @@ implementation-approachスキルで決定された実装戦略パターンに基
65
65
  2. **計画書の分析と全体設計**
66
66
  - フェーズ構成の確認
67
67
  - タスクリストの抽出
68
+ - `[x]` で完了マーク済みかつコミット済みと注記されたタスク(例: prepare-implementation レシピが解消した Phase 0)はスキップする — その作業は既にコードベースに存在する。未消化(`[ ]`)のタスクのみタスクファイルを生成し、完了済みの作業を再生成・再実行しない
68
69
  - 依存関係の特定
69
70
  - **全体最適化の検討**
70
71
  - 共通処理の識別(冗長実装の防止)
@@ -287,7 +288,7 @@ implementation-approachスキルで決定された実装戦略パターンに基
287
288
  ### 分解完了レポート
288
289
 
289
290
  ```markdown
290
- 📋 タスク分解完了
291
+ タスク分解完了
291
292
 
292
293
  計画書: [ファイル名]
293
294
  全体設計書: _overview-[plan-name].md
@@ -116,7 +116,7 @@ package.json の `packageManager` フィールドに従って実行コマンド
116
116
 
117
117
  ## 責務・権限・境界
118
118
 
119
- **範囲内**: `docs/plans/tasks/` からタスクファイルを読み込み、タスクの「Metadata」に記載された依存成果物を確認、React 関数コンポーネントと React Testing Library テストを作成、テストはコンポーネントと共に配置(co-locate)、Red→Green→Refactor のTDDを適用、進捗チェックボックスを更新(タスクファイルは常時更新。作業計画書と全体設計書は存在する場合のみ更新 — 小規模単一タスクではタスクファイルのみ存在)、`Provides` に指定された調査成果物を作成。状態遷移: `[ ]` → `[🔄]` → `[x]`。
119
+ **範囲内**: `docs/plans/tasks/` からタスクファイルを読み込み、タスクの「Metadata」に記載された依存成果物を確認、React 関数コンポーネントと React Testing Library テストを作成、テストはコンポーネントと共に配置(co-locate)、Red→Green→Refactor のTDDを適用、進捗チェックボックスを更新(タスクファイルは常時更新。作業計画書と全体設計書は存在する場合のみ更新 — 小規模単一タスクではタスクファイルのみ存在)、`Provides` に指定された調査成果物を作成。状態遷移: `[ ]` → `[x]`。
120
120
 
121
121
  **範囲外(常に)**: 全体品質チェック(品質保証工程に委譲)、コミット作成(品質チェック後に実施)、Design Doc を満たせない場合の強行(必ずエスカレーション)、クラスコンポーネント(モダン React では非推奨)。
122
122
 
@@ -116,7 +116,7 @@ package.json の `packageManager` フィールドに従って実行コマンド
116
116
 
117
117
  ## 責務・権限・境界
118
118
 
119
- **範囲内**: `docs/plans/tasks/` からタスクファイルを読み込み、タスクの「Metadata」に記載された依存成果物を確認、実装とテストを作成、Red→Green→Refactor のTDDを適用、進捗チェックボックスを更新(タスクファイルは常時更新。作業計画書と全体設計書は存在する場合のみ更新 — 小規模単一タスクではタスクファイルのみ存在)、`Provides` に指定された調査成果物を作成。状態遷移: `[ ]` → `[🔄]` → `[x]`。
119
+ **範囲内**: `docs/plans/tasks/` からタスクファイルを読み込み、タスクの「Metadata」に記載された依存成果物を確認、実装とテストを作成、Red→Green→Refactor のTDDを適用、進捗チェックボックスを更新(タスクファイルは常時更新。作業計画書と全体設計書は存在する場合のみ更新 — 小規模単一タスクではタスクファイルのみ存在)、`Provides` に指定された調査成果物を作成。状態遷移: `[ ]` → `[x]`。
120
120
 
121
121
  **範囲外(常に)**: 全体品質チェック(品質保証工程に委譲)、コミット作成(品質チェック後に実施)、Design Doc を満たせない場合の強行(必ずエスカレーション)。
122
122
 
@@ -55,7 +55,7 @@ fixture-e2e gap:
55
55
  AND e2eAbsenceReason.fixtureE2eが伝達されていない
56
56
  AND Design DocまたはUI Specにユーザー向けマルチステップジャーニーが含まれる
57
57
  THEN 作業計画書ヘッダーに追記:
58
- fixture-e2e Gap: この機能にはユーザー向けマルチステップジャーニーが含まれますが、
58
+ fixture-e2e Gap: この機能にはユーザー向けマルチステップジャーニーが含まれますが、
59
59
  fixture-e2eスケルトンが提供されていません。UI実装フェーズの前に、受入テスト生成
60
60
  へ差し戻して fixture-e2e 候補を評価する。
61
61
  検出されたジャーニー: [ジャーニーの説明とAC参照のリスト]
@@ -66,7 +66,7 @@ service-integration-e2e gap:
66
66
  AND Design Docがジャーニーに実サービス間検証(複数サービスをまたぐデータ永続化、
67
67
  トランザクション整合性、外部サービスコントラクト)を要求する
68
68
  THEN 作業計画書ヘッダーに追記:
69
- service-integration-e2e Gap: この機能はサービス境界をまたぎ、正しさが
69
+ service-integration-e2e Gap: この機能はサービス境界をまたぎ、正しさが
70
70
  実サービス間挙動に依存しますが、service-integration-e2eスケルトンが
71
71
  提供されていません。
72
72
  検出された境界: [境界の記述とAC参照のリスト]
@@ -157,8 +157,6 @@ ADRが入力に含まれる場合、またはDesign Docが「Prerequisite ADRs
157
157
  - **`scale: medium` / `scale: large`**: documentation-criteria スキルの **plan-template** に従って作業計画書を記述。フェーズ構成図とタスク依存関係図(mermaid)を含める。
158
158
  - **`scale: small`**: documentation-criteria スキルの **task-template** に従って単一タスクファイルを出力(後述「scale 別の出力モード」を参照)。フェーズ構成図・タスク依存関係図はスキップ。タスクファイルの `## Implementation Steps` セクションが実行を駆動する。
159
159
 
160
- `scale: medium` / `scale: large` の場合、計画書ヘッダーには `Implementation Readiness: pending` の行を必ず含める。マーカーの契約: 値は `pending`(初期。本エージェントが設定)、`ready`(検証完了、残存ギャップなし)、`escalated`(検証完了、残存ギャップあり)の3つのいずれか。`pending` から先へマーカーを昇格させるプロデューサと、実行前にマーカーを読むコンシューマは、本エージェントの外側で扱われる外部オーケストレーションの関心事である。
161
-
162
160
  ## Input Parameters
163
161
 
164
162
  - **mode**: `create`(デフォルト)| `update`
@@ -362,7 +360,6 @@ Design Docの技術的依存関係と実装アプローチに基づいてフェ
362
360
  - [ ] 各行の `Axis` 値が `placement` | `dependency_direction` | `contract_schema` | `data_flow` | `persistence` のちょうど1つである
363
361
  - [ ] 各行の `Source Section` が、ADR内の決定の実際の所在に一致する `Decision` または `Implementation Guidance` に設定されている
364
362
  - [ ] 全行が少なくとも1つのカバータスクにマッピングされている
365
- - [ ] 計画書ヘッダーに `Implementation Readiness: pending` を含める(medium / large のみ)
366
363
  - [ ] Design Docから検証戦略を抽出し計画書ヘッダーに記載
367
364
  - [ ] 計画書ヘッダーに証明戦略を記載(証明義務の出所 + タスクごとの伝播ルール)
368
365
  - [ ] 計画書ヘッダーにレビュースコープを記録(ベースブランチ / diff範囲 / 変更ファイル範囲)
@@ -18,9 +18,9 @@ Work plan: $ARGUMENTS
18
18
 
19
19
  ## Pre-execution Prerequisites
20
20
 
21
- ### Implementation Readiness Check
21
+ ### Work Plan Resolution
22
22
 
23
- Before any task processing, locate the work plan to gate against.
23
+ Before any task processing, locate the work plan.
24
24
 
25
25
  **When `$ARGUMENTS` is provided**, it is the work plan path supplied by the user. Use it directly without auto-resolution. Extract `{plan-name}` from the filename by stripping the `.md` extension (and any trailing `-plan` suffix when present).
26
26
 
@@ -51,27 +51,18 @@ Before any task processing, locate the work plan to gate against.
51
51
  - Otherwise (no backend signal found, OR any frontend signal present, OR layer-neutral paths only) → stop and report: "Cannot positively verify the most-recent work plan at `[path]` is a backend plan (signals examined: [list of signals checked and their results]). Pass the intended backend plan path as `$ARGUMENTS`, or run task-decomposer first to populate `docs/plans/tasks/` with backend-named task files."
52
52
  7. When no plan exists at all in `docs/plans/`, stop and report: "No work plan found. Pass a work plan path as `$ARGUMENTS`, or complete the planning phase first."
53
53
 
54
- Read the work plan header and find the line `Implementation Readiness: <status>`. Apply this rule:
55
-
56
- | Status | Action |
57
- |--------|--------|
58
- | `ready` | Proceed to Consumed Task Set computation |
59
- | `escalated` | Read the work plan's Readiness Report section, surface remaining gaps to the user via AskUserQuestion: "Implementation Readiness is `escalated` with the following remaining gaps: [list]. Continue execution? (y/n)". On `y` proceed; on `n` stop |
60
- | `pending` | Present via AskUserQuestion: "Implementation Readiness is `pending`. Run the readiness preflight first to verify the work plan is implementable, then resume. Continue without preflight? (y/n)". On `y` proceed; on `n` stop |
61
- | absent (line missing) | Treat as `pending` — older work plans created before the readiness marker existed should be preflighted explicitly |
62
-
63
54
  ### Consumed Task Set
64
55
 
65
- Compute the **Consumed Task Set** for this run — the exact files this recipe owns, executes, and later deletes. Use the same consumable patterns as the Implementation Readiness Check:
56
+ Compute the **Consumed Task Set** for this run — the exact files this recipe owns, executes, and later deletes. Use the same consumable patterns as Work Plan Resolution:
66
57
 
67
- 1. List task files in `docs/plans/tasks/` matching `{plan-name}-task-*.md` OR `{plan-name}-backend-task-*.md` for the `{plan-name}` resolved by the readiness check. `{plan-name}-frontend-task-*.md` is excluded — it is owned by the frontend build recipe
58
+ 1. List task files in `docs/plans/tasks/` matching `{plan-name}-task-*.md` OR `{plan-name}-backend-task-*.md` for the `{plan-name}` resolved by Work Plan Resolution. `{plan-name}-frontend-task-*.md` is excluded — it is owned by the frontend build recipe
68
59
  2. Exclude every file matching: `*-task-prep-*.md`, `_overview-*.md`, `*-phase*-completion.md`, `review-fixes-*.md`, `integration-tests-*-task-*.md` (these originate from other workflow phases)
69
60
 
70
61
  Every subsequent reference to "task files" in this recipe — Task Generation Decision Flow, Task Execution Cycle iteration, and Final Cleanup — uses this set, not the unrestricted `docs/plans/tasks/*.md` glob.
71
62
 
72
63
  ### Task Generation Decision Flow
73
64
 
74
- Analyze the Consumed Task Set and determine the action required. Reaching this section implies the readiness check above resolved a work plan (Steps 1-6 succeeded); the "no plan" state is already terminated by readiness-check Step 7 and never reaches this table.
65
+ Analyze the Consumed Task Set and determine the action required. Reaching this section implies Work Plan Resolution above resolved a work plan (Steps 1-6 succeeded); the "no plan" state is already terminated by Work Plan Resolution Step 7 and never reaches this table.
75
66
 
76
67
  | State | Criteria | Next Action |
77
68
  |-------|----------|-------------|
@@ -79,7 +70,7 @@ Analyze the Consumed Task Set and determine the action required. Reaching this s
79
70
  | No tasks + plan supplied via `$ARGUMENTS` | `$ARGUMENTS` provided AND Consumed Task Set empty | Confirm with user → run task-decomposer |
80
71
  | No tasks + plan auto-resolved | Consumed Task Set empty AND plan came from auto-resolution AND Step 6 confirmed at least one backend signal with zero frontend signals | Confirm with user → run task-decomposer (the layer verification in Step 6 already excluded frontend and ambiguous plans, so this is safe) |
81
72
 
82
- To bootstrap from a Design Doc when no plan exists yet, run the planning recipe first to produce a work plan, then re-invoke this recipe — the readiness check above intentionally requires a resolved work plan rather than auto-creating one, to keep the layer decision explicit.
73
+ To bootstrap from a Design Doc when no plan exists yet, run the planning recipe first to produce a work plan, then re-invoke this recipe — Work Plan Resolution above intentionally requires a resolved work plan rather than auto-creating one, to keep the layer decision explicit.
83
74
 
84
75
  ## Task Decomposition Phase (Conditional)
85
76
 
@@ -18,9 +18,9 @@ Work plan: $ARGUMENTS
18
18
 
19
19
  ## Pre-execution Prerequisites
20
20
 
21
- ### Implementation Readiness Check
21
+ ### Work Plan Resolution
22
22
 
23
- Before any task processing, locate the work plan to gate against.
23
+ Before any task processing, locate the work plan.
24
24
 
25
25
  **When `$ARGUMENTS` is provided**, it is the work plan path supplied by the user. Use it directly without auto-resolution. Extract `{plan-name}` from the filename by stripping the `.md` extension (and any trailing `-plan` suffix when present).
26
26
 
@@ -33,27 +33,18 @@ Before any task processing, locate the work plan to gate against.
33
33
  4. When at least one task file matches, the work plan is `docs/plans/{plan-name}.md` for the prefix that has the most recent task-file mtime; ties broken by the lexicographically last `{plan-name}`
34
34
  5. When no `*-frontend-task-*.md` is found AND a non-template work plan exists in `docs/plans/`, do not assume the most-recent plan applies — frontend tasks must be explicitly named. Stop and report: "No `*-frontend-task-*.md` found in `docs/plans/tasks/`. If you intended to run this recipe on a frontend plan, either re-run task-decomposer so it emits frontend-named task files, or pass the work plan path as `$ARGUMENTS`. If the plan is backend, use the backend build recipe instead."
35
35
 
36
- Read the work plan header and find the line `Implementation Readiness: <status>`. Apply this rule:
37
-
38
- | Status | Action |
39
- |--------|--------|
40
- | `ready` | Proceed to Consumed Task Set computation |
41
- | `escalated` | Read the work plan's Readiness Report section, surface remaining gaps to the user via AskUserQuestion: "Implementation Readiness is `escalated` with the following remaining gaps: [list]. Continue execution? (y/n)". On `y` proceed; on `n` stop |
42
- | `pending` | Present via AskUserQuestion: "Implementation Readiness is `pending`. Run the readiness preflight first to verify the work plan is implementable, then resume. Continue without preflight? (y/n)". On `y` proceed; on `n` stop |
43
- | absent (line missing) | Treat as `pending` — older work plans created before the readiness marker existed should be preflighted explicitly |
44
-
45
36
  ### Consumed Task Set
46
37
 
47
38
  Compute the **Consumed Task Set** for this run — the exact files this recipe owns, executes, and later deletes. Per the routing table, the only consumable pattern is:
48
39
 
49
- 1. List task files in `docs/plans/tasks/` matching `{plan-name}-frontend-task-*.md` for the `{plan-name}` resolved by the readiness check. `{plan-name}-task-*.md` and `{plan-name}-backend-task-*.md` are excluded — they route to `task-executor` and are owned by the backend build recipe
40
+ 1. List task files in `docs/plans/tasks/` matching `{plan-name}-frontend-task-*.md` for the `{plan-name}` resolved by Work Plan Resolution. `{plan-name}-task-*.md` and `{plan-name}-backend-task-*.md` are excluded — they route to `task-executor` and are owned by the backend build recipe
50
41
  2. Exclude every file matching: `*-task-prep-*.md`, `_overview-*.md`, `*-phase*-completion.md`, `review-fixes-*.md`, `integration-tests-*-task-*.md` (these originate from other workflow phases)
51
42
 
52
43
  Every subsequent reference to "task files" in this recipe — Task Generation Decision Flow, Task Execution Cycle iteration, and Final Cleanup — uses this set, not the unrestricted `docs/plans/tasks/*.md` glob.
53
44
 
54
45
  ### Task Generation Decision Flow
55
46
 
56
- Analyze the Consumed Task Set and determine the action required. Note: when `$ARGUMENTS` is empty AND no `*-frontend-task-*.md` exist, the readiness check above already stops execution — so the rows below that involve "no tasks" only fire when the user explicitly supplied `$ARGUMENTS`.
47
+ Analyze the Consumed Task Set and determine the action required. Note: when `$ARGUMENTS` is empty AND no `*-frontend-task-*.md` exist, Work Plan Resolution above already stops execution — so the rows below that involve "no tasks" only fire when the user explicitly supplied `$ARGUMENTS`.
57
48
 
58
49
  | State | Criteria | Next Action |
59
50
  |-------|----------|-------------|
@@ -45,7 +45,7 @@ After scale determination, **register all steps of the applicable subagents-orch
45
45
 
46
46
  **Check next pending task with TaskList**.
47
47
 
48
- ## 📋 subagents-orchestration-guide skill Compliance Execution
48
+ ## subagents-orchestration-guide skill Compliance Execution
49
49
 
50
50
  **Pre-execution Checklist (Required)**:
51
51
  - [ ] Confirmed relevant subagents-orchestration-guide skill flow
@@ -58,19 +58,6 @@ After scale determination, **register all steps of the applicable subagents-orch
58
58
 
59
59
  **Flow Adherence**: Follow "Autonomous Execution Task Management" in subagents-orchestration-guide skill, managing 4 steps with TaskCreate/TaskUpdate
60
60
 
61
- ## Implementation Readiness Check (between work-planner approval and task-decomposer)
62
-
63
- After work-planner completes and the user grants batch approval, before invoking task-decomposer, read the work plan header and find the line `Implementation Readiness: <status>`. Apply this rule:
64
-
65
- | Status | Action |
66
- |--------|--------|
67
- | `ready` | Proceed to task-decomposer |
68
- | `escalated` | Read the work plan's Readiness Report section, surface remaining gaps to the user via AskUserQuestion: "Implementation Readiness is `escalated` with the following remaining gaps: [list]. Continue execution? (y/n)". On `y` proceed; on `n` stop |
69
- | `pending` | Present via AskUserQuestion: "Implementation Readiness is `pending`. Run the readiness preflight first to verify the work plan is implementable, then resume. Continue without preflight? (y/n)". On `y` proceed; on `n` stop |
70
- | absent (line missing) | Treat as `pending` — older work plans created before the readiness marker existed should be preflighted explicitly |
71
-
72
- This check applies to all scales (Small / Medium / Large) because this recipe is the scale-agnostic orchestrator.
73
-
74
61
  ## Scope Boundary for Subagents
75
62
 
76
63
  Append the following block to every subagent prompt invoked from this recipe:
@@ -87,7 +74,7 @@ Additionally, include the following constraint at the end of every sub-agent pro
87
74
  [Constraint] rule-advisor can only be used by Main AI
88
75
  ```
89
76
 
90
- ## 🎯 Mandatory Orchestrator Responsibilities
77
+ ## Mandatory Orchestrator Responsibilities
91
78
 
92
79
  ### Task Execution Quality Cycle
93
80
  Following "Autonomous Execution Task Management" in subagents-orchestration-guide skill, manage these steps with TaskCreate/TaskUpdate:
@@ -76,11 +76,16 @@ Create a work plan from the selected design document, clarifying specific implem
76
76
  **Scope**: Up to work plan creation and obtaining approval for plan content.
77
77
 
78
78
  ## Response at Completion
79
- **REQUIRED**: End with the following standard response after plan content approval
79
+ **REQUIRED**: After plan content approval, output the following standard response
80
80
  ```
81
81
  Planning phase completed.
82
82
  - Work plan: docs/plans/[plan-name].md
83
83
  - Status: Approved
84
84
 
85
85
  Please provide separate instructions for implementation.
86
- ```
86
+ ```
87
+
88
+ When the approved plan includes any of the following — E2E test skeletons; a Verification Strategy referencing commands, files, functions, or endpoints not yet in the codebase; UI components without a fixture entry or dev route to render their states; or a local lane not yet confirmed to run end-to-end — append one more line as the final line of the response (omit it otherwise):
89
+ ```
90
+ Optional preflight: `/prepare-implementation docs/plans/[plan-name].md` verifies these are implementable before build (exits no-op when readiness criteria already pass).
91
+ ```
@@ -11,7 +11,7 @@ description: Verify implementation readiness and resolve gaps before the build p
11
11
  **Execution Protocol**:
12
12
  1. **Delegate all work through Agent tool** — invoke sub-agents (task-executor / task-executor-frontend / quality-fixer / quality-fixer-frontend), pass deliverable paths between them, and report results
13
13
  2. **Self-contained scope**: When gaps are found, this recipe BOTH generates resolution tasks AND executes them through the standard 4-step cycle described in subagents-orchestration-guide "Standard Flow I Manage". Recipe completes only when readiness criteria pass or remaining gaps are escalated.
14
- 3. **No-op exit**: When the readiness scan finds no failing criteria, generate no resolution tasks and exit immediately. The only file modifications in this branch are to the work plan itself — promoting the `Implementation Readiness:` header to `ready` and persisting the Readiness Report section. No code or test files are touched.
14
+ 3. **No-op exit**: When the readiness scan finds no failing criteria, generate no resolution tasks and exit immediately, presenting the Readiness Report to the user. No files are modified in this branch.
15
15
 
16
16
  Work plan: $ARGUMENTS
17
17
 
@@ -74,11 +74,9 @@ Build the Readiness Report (see Output Format) regardless of outcome.
74
74
  ### Step 3: No-op Check
75
75
 
76
76
  When every applicable criterion is `pass` (zero `fail`):
77
- - Append (or replace, if already present) a `## Implementation Readiness Report` section in the work plan immediately after the header block, using the same Readiness Report markdown defined in Output Format below
78
- - Update the work plan header `Implementation Readiness:` line to `ready` (insert it after `Related Issue/PR:` if absent)
79
- - Present the Readiness Report to the user
77
+ - Present the Readiness Report (see Output Format below) to the user
80
78
  - Exit with `outcome: ready, gaps_resolved: 0`
81
- - The work plan modifications above are the only file modifications in this branch
79
+ - No files are modified in this branch
82
80
 
83
81
  When one or more criteria are `fail` → proceed to Step 4.
84
82
 
@@ -115,20 +113,13 @@ For each resolution task, run the 4-step cycle `task-executor → escalation che
115
113
 
116
114
  Append the Scope Boundary block (below) to every subagent prompt.
117
115
 
118
- ### Step 6: Re-scan, Persist Readiness Report, Update Header, Cleanup, Exit
116
+ ### Step 6: Re-scan, Record Phase 0 Completion, Present Readiness Report, Cleanup, Exit
119
117
 
120
118
  1. **Re-scan**: Re-run the Step 2 readiness scan after all resolution tasks are committed.
121
119
 
122
- 2. **Persist Readiness Report into work plan body**: Append (or replace, if already present) a `## Implementation Readiness Report` section in the work plan immediately after the header block. Use the same Readiness Report markdown defined in Output Format below. Downstream build/implement recipes read this section when the header is `escalated` to surface remaining gaps to the user.
120
+ 2. **Record Phase 0 completion in the work plan**: For each Phase 0 resolution task that was committed, check off its checkbox (`[x]`) in the work plan's Phase 0 section and annotate it as committed (append ` committed`). This records the durable outcome in the plan so the downstream task-decomposer skips already-committed Phase 0 work instead of regenerating and re-executing it.
123
121
 
124
- 3. **Update work plan header**: Locate the line `Implementation Readiness: pending` in the work plan and rewrite it based on the re-scan outcome:
125
-
126
- | Re-scan result | New header value |
127
- |----------------|------------------|
128
- | All applicable criteria `pass` | `Implementation Readiness: ready` |
129
- | One or more `fail` remain | `Implementation Readiness: escalated` |
130
-
131
- If the line is absent (older work plan format), insert it after the `Related Issue/PR:` line.
122
+ 3. **Present Readiness Report**: Present the Readiness Report (see Output Format below) to the user. The report is shown in-session and is not written into the work plan the durable output of this recipe is the committed Phase 0 resolution tasks (recorded as completed in the plan per Step 6.2), not a persisted report.
132
123
 
133
124
  4. **Final Cleanup**: Delete every prep task file this recipe created for the current `{plan-name}` (`docs/plans/tasks/{plan-name}-backend-task-prep-*.md` and `docs/plans/tasks/{plan-name}-frontend-task-prep-*.md`) AND the phase-completion file generated for prep phases (`docs/plans/tasks/{plan-name}-phase0-completion.md` when present, since prep tasks live in Phase 0). Prep task files for other plans are out of scope — this recipe deletes only what it created for the current run. Their work is committed; `docs/plans/` is ephemeral working state and is not retained between recipe runs. The work plan itself is preserved for the downstream build/implement phase.
134
125
 
@@ -185,7 +176,6 @@ Gaps resolved: [N]
185
176
  - [ ] Readiness scan run with per-criterion result and evidence recorded
186
177
  - [ ] No-op exit when all `pass`, OR resolution tasks generated, approved, and executed via the 4-step cycle
187
178
  - [ ] Re-scan run after the last resolution task commits
188
- - [ ] `## Implementation Readiness Report` section persisted into the work plan body
189
- - [ ] Work plan header `Implementation Readiness:` line updated to `ready` or `escalated`
179
+ - [ ] Committed Phase 0 tasks checked off (`[x]`) in the work plan so downstream decomposition skips them
190
180
  - [ ] Prep task files (and Phase 0 phase-completion file when generated) deleted from `docs/plans/tasks/`
191
181
  - [ ] Final report presented to the user
@@ -43,9 +43,9 @@ Present proposals to user and apply after approval:
43
43
 
44
44
  ```
45
45
  [1/N] typescript-rules
46
- sections: synchronized
47
- 💡 tags proposed: +[functional-programming]
48
- 💡 typical-use: "old description" → "new description"
46
+ sections: synchronized
47
+ tags proposed: +[functional-programming]
48
+ typical-use: "old description" → "new description"
49
49
  ```
50
50
 
51
51
  ## Completion Criteria
@@ -18,9 +18,9 @@ description: 分解済みタスクを自律実行モードで実装
18
18
 
19
19
  ## 実行前提条件
20
20
 
21
- ### Implementation Readinessチェック
21
+ ### 作業計画書の解決
22
22
 
23
- タスク処理の前に、ゲート対象となる作業計画書を特定する。
23
+ タスク処理の前に、作業計画書を特定する。
24
24
 
25
25
  **`$ARGUMENTS`が指定されている場合**は、それがユーザーから渡された作業計画書のパスである。自動解決を行わずそのまま使用する。`{plan-name}`はファイル名から `.md` 拡張子(および末尾に `-plan` がある場合はそれも)を除いて抽出する。
26
26
 
@@ -51,35 +51,26 @@ description: 分解済みタスクを自律実行モードで実装
51
51
  - それ以外(backend 信号がない、または frontend 信号が1つでもある、または layer-neutral なパスのみ)→ 停止して報告する: 「最も新しい作業計画書 `[path]` が backend 計画であることを確証できません(確認した信号と結果: [リスト])。意図する backend 計画書のパスを `$ARGUMENTS` で指定するか、task-decomposer を先に実行して `docs/plans/tasks/` に backend 命名のタスクファイルを出力してください。」
52
52
  7. `docs/plans/`に計画書が一切存在しない場合は、停止して報告する: 「作業計画書が見つかりません。作業計画書のパスを `$ARGUMENTS` で指定するか、計画フェーズを先に完了してください。」
53
53
 
54
- 作業計画書のヘッダを読み、`Implementation Readiness: <status>`の行を見つける。以下のルールを適用する:
55
-
56
- | ステータス | アクション |
57
- |--------|--------|
58
- | `ready` | Consumed Task Set の計算へ進む |
59
- | `escalated` | 作業計画書のReadiness Reportセクションを読み、AskUserQuestionで残存ギャップをユーザーに提示する: 「Implementation Readinessが`escalated`で、以下の残存ギャップがあります: [リスト]。実行を継続しますか?(y/n)」。`y`なら進む、`n`なら停止 |
60
- | `pending` | AskUserQuestionで提示する: 「Implementation Readinessが`pending`です。事前にreadiness preflightを実行して作業計画書の実装可能性を検証してから再開してください。preflightなしで継続しますか?(y/n)」。`y`なら進む、`n`なら停止 |
61
- | 行が存在しない | `pending`として扱う — readinessマーカー導入前に作成された古い作業計画書は明示的にpreflightすべき |
62
-
63
54
  ### Consumed Task Set
64
55
 
65
- 本実行で消費する **Consumed Task Set** を計算する — 本レシピが所有・実行・後で削除する正確なファイル群。Implementation Readinessチェックと同じ消費可能パターンを使用する:
56
+ 本実行で消費する **Consumed Task Set** を計算する — 本レシピが所有・実行・後で削除する正確なファイル群。作業計画書の解決と同じ消費可能パターンを使用する:
66
57
 
67
- 1. Implementation Readinessチェックで解決した `{plan-name}` について、`docs/plans/tasks/`内で `{plan-name}-task-*.md` または `{plan-name}-backend-task-*.md` にマッチするタスクファイルを列挙する。`{plan-name}-frontend-task-*.md` は除外する — frontend build レシピが所有する
58
+ 1. 作業計画書の解決で確定した `{plan-name}` について、`docs/plans/tasks/`内で `{plan-name}-task-*.md` または `{plan-name}-backend-task-*.md` にマッチするタスクファイルを列挙する。`{plan-name}-frontend-task-*.md` は除外する — frontend build レシピが所有する
68
59
  2. 以下にマッチするファイルを除外する: `*-task-prep-*.md`、`_overview-*.md`、`*-phase*-completion.md`、`review-fixes-*.md`、`integration-tests-*-task-*.md`(これらは他のワークフローフェーズに由来する)
69
60
 
70
61
  本レシピ内で「タスクファイル」と参照する箇所すべて — タスク生成判定フロー、タスク実行サイクルの反復、最終クリーンアップ — はこのセットを使用する。`docs/plans/tasks/*.md` を制限なく glob しない。
71
62
 
72
63
  ### タスク生成判定フロー
73
64
 
74
- Consumed Task Set を確認し、適切な対応を決定する。注: 本セクションに到達するということは、上記の readiness check が作業計画書を解決済み(Steps 1-6 が成功)であることを意味する。「計画書なし」の状態は readiness check の Step 7 が既に終了させており、本表には到達しない。
65
+ Consumed Task Set を確認し、適切な対応を決定する。注: 本セクションに到達するということは、上記の作業計画書の解決(Steps 1-6 が成功)で作業計画書が確定済みであることを意味する。「計画書なし」の状態は作業計画書の解決の Step 7 が既に終了させており、本表には到達しない。
75
66
 
76
67
  | 状態 | 判定基準 | 次のアクション |
77
68
  |------|---------|--------------|
78
69
  | タスク存在 | Consumed Task Set が非空 | ユーザーの実行指示をバッチ承認として自律実行へ移行 |
79
70
  | タスクなし + `$ARGUMENTS`で計画書指定 | `$ARGUMENTS`が提供され Consumed Task Set が空 | ユーザーに確認 → task-decomposer実行 |
80
- | タスクなし + 計画書を自動解決 | Consumed Task Set が空かつ計画書が自動解決(readiness check の Step 6 経由)で得られ、backend 信号 ≥1 かつ frontend 信号 = 0 が確認済み | ユーザーに確認 → task-decomposer実行(Step 6 のレイヤー検証で frontend / 不確定な計画は既に除外されているため安全) |
71
+ | タスクなし + 計画書を自動解決 | Consumed Task Set が空かつ計画書が自動解決(作業計画書の解決の Step 6 経由)で得られ、backend 信号 ≥1 かつ frontend 信号 = 0 が確認済み | ユーザーに確認 → task-decomposer実行(Step 6 のレイヤー検証で frontend / 不確定な計画は既に除外されているため安全) |
81
72
 
82
- Design Doc から作業計画書がまだない状態で着手したい場合は、先に計画レシピを実行して計画書を生成してから本レシピを再起動する — 上記 readiness check は意図的に自動生成を行わず、レイヤー判断を明示的に保つ。
73
+ Design Doc から作業計画書がまだない状態で着手したい場合は、先に計画レシピを実行して計画書を生成してから本レシピを再起動する — 上記の作業計画書の解決は意図的に自動生成を行わず、レイヤー判断を明示的に保つ。
83
74
 
84
75
  ## タスク分解フェーズ(条件付き実行)
85
76
 
@@ -18,9 +18,9 @@ description: フロントエンド実装を自律実行モードで実行
18
18
 
19
19
  ## 実行前提条件
20
20
 
21
- ### Implementation Readinessチェック
21
+ ### 作業計画書の解決
22
22
 
23
- タスク処理の前に、ゲート対象となる作業計画書を特定する。
23
+ タスク処理の前に、作業計画書を特定する。
24
24
 
25
25
  **`$ARGUMENTS`が指定されている場合**は、それがユーザーから渡された作業計画書のパスである。自動解決を行わずそのまま使用する。`{plan-name}`はファイル名から `.md` 拡張子(および末尾に `-plan` がある場合はそれも)を除いて抽出する。
26
26
 
@@ -33,27 +33,18 @@ description: フロントエンド実装を自律実行モードで実行
33
33
  4. 少なくとも1つのタスクファイルがマッチした場合、最も新しい mtime を持つ `{plan-name}` の `docs/plans/{plan-name}.md` を作業計画書とする。タイは辞書順最大の `{plan-name}` で解決する
34
34
  5. `*-frontend-task-*.md` が見つからず、かつ `docs/plans/`に非テンプレートの作業計画書が存在する場合、最も新しい計画書を自動採用してはならない — frontend タスクは明示的に命名されている必要がある。停止して報告する: 「`docs/plans/tasks/`に `*-frontend-task-*.md` が見つかりませんでした。本レシピを frontend 計画に対して実行する意図であれば、task-decomposer を再実行して frontend 命名のタスクファイルを出力させるか、作業計画書のパスを `$ARGUMENTS` で指定してください。計画が backend ならば、backend build レシピを使用してください。」
35
35
 
36
- 作業計画書のヘッダを読み、`Implementation Readiness: <status>`の行を見つける。以下のルールを適用する:
37
-
38
- | ステータス | アクション |
39
- |--------|--------|
40
- | `ready` | Consumed Task Set の計算へ進む |
41
- | `escalated` | 作業計画書のReadiness Reportセクションを読み、AskUserQuestionで残存ギャップをユーザーに提示する: 「Implementation Readinessが`escalated`で、以下の残存ギャップがあります: [リスト]。実行を継続しますか?(y/n)」。`y`なら進む、`n`なら停止 |
42
- | `pending` | AskUserQuestionで提示する: 「Implementation Readinessが`pending`です。事前にreadiness preflightを実行して作業計画書の実装可能性を検証してから再開してください。preflightなしで継続しますか?(y/n)」。`y`なら進む、`n`なら停止 |
43
- | 行が存在しない | `pending`として扱う — readinessマーカー導入前に作成された古い作業計画書は明示的にpreflightすべき |
44
-
45
36
  ### Consumed Task Set
46
37
 
47
38
  本実行で消費する **Consumed Task Set** を計算する — 本レシピが所有・実行・後で削除する正確なファイル群。ルーティング表により、消費可能なパターンは1つだけ:
48
39
 
49
- 1. Implementation Readinessチェックで解決した `{plan-name}` について、`docs/plans/tasks/`内で `{plan-name}-frontend-task-*.md` にマッチするタスクファイルを列挙する。`{plan-name}-task-*.md` および `{plan-name}-backend-task-*.md` は除外する — `task-executor` にルーティングされ、backend build レシピが所有する
40
+ 1. 作業計画書の解決で確定した `{plan-name}` について、`docs/plans/tasks/`内で `{plan-name}-frontend-task-*.md` にマッチするタスクファイルを列挙する。`{plan-name}-task-*.md` および `{plan-name}-backend-task-*.md` は除外する — `task-executor` にルーティングされ、backend build レシピが所有する
50
41
  2. 以下にマッチするファイルを除外する: `*-task-prep-*.md`、`_overview-*.md`、`*-phase*-completion.md`、`review-fixes-*.md`、`integration-tests-*-task-*.md`(これらは他のワークフローフェーズに由来する)
51
42
 
52
43
  本レシピ内で「タスクファイル」と参照する箇所すべて — タスク生成判定フロー、タスク実行サイクルの反復、最終クリーンアップ — はこのセットを使用する。`docs/plans/tasks/*.md` を制限なく glob しない。
53
44
 
54
45
  ### タスク生成判定フロー
55
46
 
56
- Consumed Task Set を確認し、適切な対応を決定する。注: `$ARGUMENTS`が空かつ `*-frontend-task-*.md` が存在しない場合は、上記の readiness check が既に実行を停止している — 以下の表で「タスクなし」が関わる行は、ユーザーが明示的に `$ARGUMENTS` を指定した場合にのみ発火する。
47
+ Consumed Task Set を確認し、適切な対応を決定する。注: `$ARGUMENTS`が空かつ `*-frontend-task-*.md` が存在しない場合は、上記の作業計画書の解決が既に実行を停止している — 以下の表で「タスクなし」が関わる行は、ユーザーが明示的に `$ARGUMENTS` を指定した場合にのみ発火する。
57
48
 
58
49
  | 状態 | 基準 | 次のアクション |
59
50
  |------|------|--------------|
@@ -45,7 +45,7 @@ requirement-analyzerの`crossLayerScope`がレイヤー横断(backend + fronte
45
45
 
46
46
  **TaskListで次のpendingタスクを確認して実行**。
47
47
 
48
- ## 📋 subagents-orchestration-guideスキル準拠の実行
48
+ ## subagents-orchestration-guideスキル準拠の実行
49
49
 
50
50
  **実行前チェック(必須)**:
51
51
  - [ ] subagents-orchestration-guideスキルの該当フローを確認した
@@ -58,19 +58,6 @@ requirement-analyzerの`crossLayerScope`がレイヤー横断(backend + fronte
58
58
 
59
59
  **フロー厳守**: subagents-orchestration-guideスキルの「自律実行中のタスク管理」に従い、TaskCreate/TaskUpdateで4ステップを管理する
60
60
 
61
- ## Implementation Readinessチェック(work-planner承認とtask-decomposerの間)
62
-
63
- work-plannerが完了しユーザーから一括承認を得た後、task-decomposerを呼び出す前に作業計画書のヘッダを読み、`Implementation Readiness: <status>`の行を見つける。以下のルールを適用する:
64
-
65
- | ステータス | アクション |
66
- |--------|--------|
67
- | `ready` | task-decomposerに進む |
68
- | `escalated` | 作業計画書のReadiness Reportセクションを読み、AskUserQuestionで残存ギャップをユーザーに提示する: 「Implementation Readinessが`escalated`で、以下の残存ギャップがあります: [リスト]。実行を継続しますか?(y/n)」。`y`なら進む、`n`なら停止 |
69
- | `pending` | AskUserQuestionで提示する: 「Implementation Readinessが`pending`です。事前にreadiness preflightを実行して作業計画書の実装可能性を検証してから再開してください。preflightなしで継続しますか?(y/n)」。`y`なら進む、`n`なら停止 |
70
- | 行が存在しない | `pending`として扱う — readinessマーカー導入前に作成された古い作業計画書は明示的にpreflightすべき |
71
-
72
- このチェックは全規模(Small / Medium / Large)に適用される。本レシピは規模に依存しないオーケストレーターであるため。
73
-
74
61
  ## サブエージェントのスコープ境界
75
62
 
76
63
  本レシピから呼び出すサブエージェントプロンプトの末尾に以下のブロックを必ず付与する:
@@ -87,7 +74,7 @@ Escalate when the required fix or investigation falls outside that scope.
87
74
  [Constraint] rule-advisor can only be used by Main AI
88
75
  ```
89
76
 
90
- ## 🎯 オーケストレーターとしての必須責務
77
+ ## オーケストレーターとしての必須責務
91
78
 
92
79
  ### タスク実行品質サイクル
93
80
  subagents-orchestration-guideスキルの「自律実行中のタスク管理」に従い、TaskCreate/TaskUpdateで以下のステップを管理:
@@ -76,7 +76,7 @@ description: 設計書から作業計画書を作成し計画承認を取得
76
76
  **スコープ**: 作業計画書作成と計画内容の承認取得まで。
77
77
 
78
78
  ## 終了時の応答
79
- **必須**: 計画内容の承認後は以下の定型応答で終了
79
+ **必須**: 計画内容の承認後は以下の定型応答を出力
80
80
  ```
81
81
  計画フェーズが完了しました。
82
82
  - 作業計画書: docs/plans/[plan-name].md
@@ -84,3 +84,8 @@ description: 設計書から作業計画書を作成し計画承認を取得
84
84
 
85
85
  実装は別途ご指示ください。
86
86
  ```
87
+
88
+ 承認された計画が次のいずれかを含む場合 — E2Eテストスケルトン;コードベースにまだ存在しないコマンド・ファイル・関数・エンドポイントを参照する検証戦略;視覚状態を描画する fixture エントリや開発用ルートを持たない UI コンポーネント;エンドツーエンドでの動作が未確認のローカルレーン — 応答の最終行として次の1行を追加する(該当しなければ省略する):
89
+ ```
90
+ 任意の事前検証: `/prepare-implementation docs/plans/[plan-name].md` で、ビルド前にこれらが実装可能かを検証できる(readiness 基準がすべて満たされていれば no-op で終了)。
91
+ ```
@@ -11,14 +11,14 @@ description: 実装着手前に readiness を検証しギャップを解消す
11
11
  **実行プロトコル**:
12
12
  1. **全作業をAgentツールでサブエージェントに委譲** — サブエージェント(task-executor / task-executor-frontend / quality-fixer / quality-fixer-frontend)の呼び出し、成果物パスの受け渡し、結果の報告
13
13
  2. **自己完結スコープ**: ギャップが見つかった場合、本レシピは解消タスクの生成と、subagents-orchestration-guide「標準フロー」で説明される標準4ステップサイクルでの実行の**両方**を行う。readiness基準がパスするか残存ギャップがエスカレーションされた時点でレシピは完了する。
14
- 3. **No-op終了**: readinessスキャンで失敗基準がない場合、解消タスクは生成せず即座に終了する。本ブランチのファイル変更は作業計画書本体のみ `Implementation Readiness:`ヘッダを `ready` に昇格し、Readiness Reportセクションを永続化する。コードやテストファイルには触れない。
14
+ 3. **No-op終了**: readinessスキャンで失敗基準がない場合、解消タスクは生成せず、Readiness Report をユーザーに提示して即座に終了する。この no-op 経路ではファイルを変更しない。
15
15
 
16
16
  作業計画書: $ARGUMENTS
17
17
 
18
18
  ## 適用される条件
19
19
 
20
20
  build/implement フェーズの前に、以下のいずれかが該当する場合に実行する:
21
- - 作業計画書の検証戦略がコードベースにまだ存在しないコマンド・ファイル・関数・エンドポイントを参照する Design Doc から作成された
21
+ - コードベースにまだ存在しないコマンド・ファイル・関数・エンドポイントを参照する検証戦略を含む Design Doc から、作業計画書が作成された
22
22
  - 作業計画書にE2Eテストスケルトンが含まれる(seed data、auth fixture、環境変数、または外部モックが未対応の可能性あり)
23
23
  - 作業計画書がUIコンポーネントに触れるが、それらの視覚状態を描画するfixtureエントリや開発用ルートがない
24
24
  - ローカルレーンが本機能領域でエンドツーエンドに動作することをチームが事前に確認していない
@@ -74,11 +74,9 @@ R4とR5は、トリガー信号が作業計画書に現れた場合のみ評価
74
74
  ### Step 3: No-opチェック
75
75
 
76
76
  該当する全基準が `pass`(`fail`ゼロ)の場合:
77
- - 作業計画書のヘッダブロック直後に `## Implementation Readiness Report` セクションを追記(既存なら置換)する。出力フォーマットで定義したReadiness Reportのmarkdownを使用する
78
- - 作業計画書ヘッダの `Implementation Readiness:` 行を `ready` に更新する(行が無ければ `Related Issue/PR:` の後に挿入する)
79
- - Readiness Reportをユーザーに提示する
77
+ - Readiness Report(下記の出力フォーマット参照)をユーザーに提示する
80
78
  - `outcome: ready, gaps_resolved: 0` で終了する
81
- - 本ブランチのファイル変更は上記の作業計画書への変更のみ
79
+ - この no-op 経路ではファイルを変更しない
82
80
 
83
81
  `fail`が1件以上ある場合 → Step 4へ進む。
84
82
 
@@ -115,20 +113,13 @@ R4とR5は、トリガー信号が作業計画書に現れた場合のみ評価
115
113
 
116
114
  各サブエージェントプロンプトの末尾に下記の「サブエージェントのスコープ境界」ブロックを必ず付与する。
117
115
 
118
- ### Step 6: 再スキャン、Readiness Reportの永続化、ヘッダ更新、クリーンアップ、終了
116
+ ### Step 6: 再スキャン、Phase 0 完了の記録、Readiness Report の提示、クリーンアップ、終了
119
117
 
120
118
  1. **再スキャン**: 全解消タスクのコミット後、Step 2のreadinessスキャンを再実行する。
121
119
 
122
- 2. **Readiness Reportを作業計画書本体に永続化する**: 作業計画書のヘッダブロック直後に `## Implementation Readiness Report` セクションを追記(既存なら置換)する。出力フォーマットで定義したReadiness Reportのmarkdownを使用する。下流のbuild/implementレシピは、ヘッダが `escalated` の場合に本セクションを読み、残存ギャップをユーザーに提示する。
120
+ 2. **作業計画書に Phase 0 完了を記録する**: コミットした各 Phase 0 解消タスクについて、作業計画書の Phase 0 セクションのチェックボックスを `[x]` にし、コミット済みである旨を注記する(` — committed` を付す)。これにより完了結果が計画書に残り、下流の task-decomposer がコミット済みの Phase 0 を再生成・再実行せずスキップできる。
123
121
 
124
- 3. **作業計画書ヘッダの更新**: 作業計画書内の `Implementation Readiness: pending` 行を特定し、再スキャンの結果に応じて書き換える:
125
-
126
- | 再スキャン結果 | 新しいヘッダ値 |
127
- |--------------|--------------|
128
- | 該当する全基準が `pass` | `Implementation Readiness: ready` |
129
- | `fail` が1件以上残存 | `Implementation Readiness: escalated` |
130
-
131
- 行が存在しない場合(古い作業計画書フォーマット)、`Related Issue/PR:` 行の後に挿入する。
122
+ 3. **Readiness Report の提示**: Readiness Report(下記の出力フォーマット参照)をユーザーに提示する。レポートはセッション内で提示し、作業計画書には書き込まない — 本レシピの永続的な成果物は、コミット済みの Phase 0 解消タスク(Step 6.2 で計画書に完了として記録)であり、永続化されたレポートではない。
132
123
 
133
124
  4. **最終クリーンアップ**: 本実行で作成した、現在の `{plan-name}` に該当するprepタスクファイル(`docs/plans/tasks/{plan-name}-backend-task-prep-*.md` および `docs/plans/tasks/{plan-name}-frontend-task-prep-*.md`)と、prepフェーズ用に生成されたフェーズ完了ファイル(`docs/plans/tasks/{plan-name}-phase0-completion.md` が存在する場合。prepタスクはPhase 0に置かれるため)をすべて削除する。他の計画のprepタスクファイルはスコープ外 — 本レシピは現在の実行で作成したものだけを削除する。作業内容はコミット済みで、`docs/plans/`はレシピ実行間で保持しない一時的な作業状態である。作業計画書本体は下流のbuild/implementフェーズのために保持する。
134
125
 
@@ -185,7 +176,6 @@ Escalate when the required fix or investigation falls outside that scope.
185
176
  - [ ] readinessスキャンが実行され、各基準の結果と根拠が記録されている
186
177
  - [ ] 全`pass`の場合のno-op終了、または解消タスクの生成・承認・4ステップサイクル実行のいずれかが行われている
187
178
  - [ ] 最後の解消タスクのコミット後に再スキャンが実行されている
188
- - [ ] `## Implementation Readiness Report` セクションが作業計画書本体に永続化されている
189
- - [ ] 作業計画書ヘッダの `Implementation Readiness:` 行が `ready` または `escalated` に更新されている
179
+ - [ ] コミット済みの Phase 0 タスクが作業計画書で `[x]` 完了マークされ、下流の分解でスキップされる
190
180
  - [ ] prepタスクファイル(および生成された場合のPhase 0フェーズ完了ファイル)が `docs/plans/tasks/` から削除されている
191
181
  - [ ] 最終レポートがユーザーに提示されている
@@ -43,9 +43,9 @@ description: スキル修正後のメタデータ同期とrule-advisor精度最
43
43
 
44
44
  ```
45
45
  [1/N] typescript-rules
46
- sections: 同期完了
47
- 💡 tags提案: +[functional-programming]
48
- 💡 typical-use: "旧記述" → "新記述"
46
+ sections: 同期完了
47
+ tags提案: +[functional-programming]
48
+ typical-use: "旧記述" → "新記述"
49
49
  ```
50
50
 
51
51
  ## 完了条件
@@ -5,8 +5,6 @@ Type: feature|fix|refactor
5
5
  Estimated Impact: X files
6
6
  Related Issue/PR: #XXX (if any)
7
7
  Review Scope: [planned-files scope derived from Design Doc and task targets; for a revision plan over existing work, base branch + diff range]
8
- <!-- The line below is medium / large only — small scale uses task-template instead of this plan-template. Keep the value line free of trailing comments so downstream parsers can extract the bare status (pending | ready | escalated). -->
9
- Implementation Readiness: pending
10
8
 
11
9
  ## Related Documents
12
10
  - Design Doc(s):
@@ -45,6 +45,8 @@ The two E2E lanes are budgeted independently — having a fixture-e2e for a jour
45
45
 
46
46
  ### Required Comment Format
47
47
 
48
+ The committed skeleton imports only the test framework (for `describe`/`it`/`it.todo`); the module under test is imported by the implementing task, never by the skeleton — a skeleton that references a not-yet-created module can fail gates that type-check, compile, or load test files before implementation begins.
49
+
48
50
  Each test MUST include the following annotations.
49
51
 
50
52
  ```typescript
@@ -216,14 +216,9 @@ According to scale determination:
216
216
 
217
217
  Note: At Small scale the implementation step still runs through task-executor with the standard 4-step cycle (`task-executor → escalation judgment → quality-fixer → commit`). Direct orchestrator edits are not used.
218
218
 
219
- ### Implementation Readiness Marker
219
+ ### Optional Preflight
220
220
 
221
- For Medium / Large scale, after Batch approval the work plan carries an `Implementation Readiness:` header (work-planner emits `pending`; promotion to `ready` or `escalated` is an external orchestration concern). The marker takes one of three values:
222
- - `pending` — initial state set by work-planner
223
- - `ready` — readiness verification has completed with no remaining gaps; safe to start the task execution cycle
224
- - `escalated` — readiness verification has completed but residual gaps require user judgment before execution
225
-
226
- External orchestration owns both the producer that promotes the marker beyond `pending` and the consumer that reads it before invoking task-executor. This guide does not invoke any orchestrator above the agent layer; agents read/write the marker only when explicitly asked.
221
+ For Medium / Large scale, after Batch approval implementation proceeds directly. Verifying the plan is implementable end-to-end (verification-strategy references, fixtures, UI rendering surface, E2E/local lane environment) is an optional preflight the user runs at their discretion via the prepare-implementation recipe, which exits no-op when readiness criteria already pass. This guide does not invoke any orchestrator above the agent layer.
227
222
 
228
223
  ## Cross-Layer Orchestration
229
224
 
@@ -5,8 +5,6 @@
5
5
  想定影響範囲: Xファイル
6
6
  関連Issue/PR: #XXX(該当する場合)
7
7
  レビュースコープ: [Design Docとタスク対象から導出した変更予定ファイルの範囲。既存作業に対する改訂計画の場合はベースブランチ + diff範囲]
8
- <!-- 下記の行はmedium / large規模のみ — small規模はこのplan-templateではなくtask-templateを使用する。値の行は末尾コメントを付けず、下流のパーサがbare statusの抽出(pending | ready | escalated)を行えるように保つこと。 -->
9
- Implementation Readiness: pending
10
8
 
11
9
  ## 関連ドキュメント
12
10
  - 設計書:
@@ -45,6 +45,8 @@ description: 統合テストとE2Eテストを設計。モック境界と振る
45
45
 
46
46
  ### 必須コメント形式
47
47
 
48
+ コミットするスケルトンは、テストフレームワーク(`describe`/`it`/`it.todo` 用)のみを import する。テスト対象モジュールは実装タスクが import するものであり、スケルトンでは import しない — まだ作成されていないモジュールを参照するスケルトンは、テストファイルを型チェック・コンパイル・ロードするゲートが実装着手前に失敗し得る。
49
+
48
50
  各テストに以下のアノテーションを含めること。
49
51
 
50
52
  ```typescript
@@ -211,14 +211,9 @@ quality-fixerが `status: "blocked"` を返した場合、`reason`で判別:
211
211
 
212
212
  注: 小規模スケールでも実装ステップは task-executor を介して標準の4ステップサイクル(`task-executor → エスカレーション判定 → quality-fixer → commit`)で実行する。オーケストレーターによる直接編集は行わない。
213
213
 
214
- ### Implementation Readinessマーカー
214
+ ### 任意の事前検証(Optional Preflight)
215
215
 
216
- Medium / Large規模では、一括承認後、作業計画書のヘッダに `Implementation Readiness:` 行が含まれる(work-plannerが`pending`を出力する。`ready` または `escalated` への昇格は外部オーケストレーションの関心事である)。マーカーは以下3値のいずれかを取る:
217
- - `pending` — work-plannerが設定する初期状態
218
- - `ready` — readiness検証が完了し残存ギャップなし。タスク実行サイクルを安全に開始できる
219
- - `escalated` — readiness検証は完了したが残存ギャップが存在し、実行前にユーザー判断が必要
220
-
221
- `pending`から先へマーカーを昇格させるプロデューサと、task-executor呼び出し前にマーカーを読むコンシューマは、いずれも外部オーケストレーションが所有する。本ガイドはエージェント層の上位にあるオーケストレーターを呼び出さない。エージェントは明示的に依頼された場合にのみマーカーを読み書きする。
216
+ Medium / Large規模では、一括承認後、実装はそのまま進行する。計画がエンドツーエンドで実装可能か(検証戦略の参照、fixture、UI 描画面、E2E/ローカルレーン環境)の検証は、ユーザーが任意に prepare-implementation レシピで実行する事前検証であり、readiness 基準が既に満たされていれば no-op で終了する。本ガイドはエージェント層の上位にあるオーケストレーターを呼び出さない。
222
217
 
223
218
  ## レイヤー横断オーケストレーション
224
219
 
package/CHANGELOG.md CHANGED
@@ -5,6 +5,14 @@ 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.23.4] - 2026-06-09
9
+
10
+ ### Changed
11
+
12
+ - **Implementation Readiness gate → optional preflight** (agents, commands, skills) — The work plan no longer carries an `Implementation Readiness` marker and the build / front-build / implement recipes no longer halt on it. Verifying a plan is implementable end-to-end is now an optional, user-invoked preflight via `prepare-implementation`, which presents its Readiness Report in-session (instead of persisting it into the plan or promoting a header marker) and records committed Phase 0 tasks as done so `task-decomposer` does not regenerate them. `plan` surfaces the preflight as a conditional suggestion; `subagents-orchestration-guide` describes it as optional. Applied across en/ja.
13
+ - **Test skeletons stay green under static gates** (agents, skills) — `acceptance-test-generator` and `integration-e2e-testing` bound skeleton generation so a committed skeleton imports only the test framework (no module under test, assertions, or mocks); the implementing task adds executable code alongside the implementation, keeping a freshly committed skeleton green under typecheck / compile / test-load gates.
14
+ - **Removed decorative emojis** (agents, commands) — Stripped pictographic emojis from prompt files and simplified `task-executor` progress states to `[ ] → [x]`. Functional symbols (`[ ]` / `[x]` checkboxes, `→` flow arrows, check / cross marks) are retained.
15
+
8
16
  ## [1.23.3] - 2026-06-06
9
17
 
10
18
  ### Added
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-ai-project",
3
- "version": "1.23.3",
3
+ "version": "1.23.4",
4
4
  "packageManager": "npm@10.8.2",
5
5
  "description": "TypeScript boilerplate with skills and sub-agents for Claude Code. Prevents context exhaustion through role-based task splitting.",
6
6
  "keywords": [