create-ai-project 1.23.2 → 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.
- package/.claude/agents-en/acceptance-test-generator.md +4 -2
- package/.claude/agents-en/code-reviewer.md +3 -0
- package/.claude/agents-en/quality-fixer-frontend.md +3 -3
- package/.claude/agents-en/quality-fixer.md +3 -3
- package/.claude/agents-en/task-decomposer.md +2 -1
- package/.claude/agents-en/task-executor-frontend.md +8 -2
- package/.claude/agents-en/task-executor.md +8 -2
- package/.claude/agents-en/technical-designer-frontend.md +10 -48
- package/.claude/agents-en/technical-designer.md +10 -26
- package/.claude/agents-en/work-planner.md +2 -5
- package/.claude/agents-ja/acceptance-test-generator.md +4 -2
- package/.claude/agents-ja/code-reviewer.md +3 -0
- package/.claude/agents-ja/quality-fixer-frontend.md +3 -3
- package/.claude/agents-ja/quality-fixer.md +3 -3
- package/.claude/agents-ja/task-decomposer.md +2 -1
- package/.claude/agents-ja/task-executor-frontend.md +8 -2
- package/.claude/agents-ja/task-executor.md +8 -2
- package/.claude/agents-ja/technical-designer-frontend.md +10 -48
- package/.claude/agents-ja/technical-designer.md +9 -25
- package/.claude/agents-ja/work-planner.md +2 -5
- package/.claude/commands-en/build.md +6 -15
- package/.claude/commands-en/front-build.md +4 -13
- package/.claude/commands-en/implement.md +2 -15
- package/.claude/commands-en/plan.md +7 -2
- package/.claude/commands-en/prepare-implementation.md +7 -17
- package/.claude/commands-en/sync-skills.md +3 -3
- package/.claude/commands-ja/build.md +7 -16
- package/.claude/commands-ja/front-build.md +4 -13
- package/.claude/commands-ja/implement.md +2 -15
- package/.claude/commands-ja/plan.md +6 -1
- package/.claude/commands-ja/prepare-implementation.md +8 -18
- package/.claude/commands-ja/sync-skills.md +3 -3
- package/.claude/skills-en/documentation-criteria/references/plan-template.md +0 -2
- package/.claude/skills-en/frontend-technical-spec/SKILL.md +4 -4
- package/.claude/skills-en/frontend-typescript-rules/SKILL.md +45 -111
- package/.claude/skills-en/frontend-typescript-testing/SKILL.md +8 -6
- package/.claude/skills-en/integration-e2e-testing/SKILL.md +2 -0
- package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +2 -7
- package/.claude/skills-en/task-analyzer/references/skills-index.yaml +9 -11
- package/.claude/skills-ja/documentation-criteria/references/plan-template.md +0 -2
- package/.claude/skills-ja/frontend-technical-spec/SKILL.md +3 -3
- package/.claude/skills-ja/frontend-typescript-rules/SKILL.md +43 -288
- package/.claude/skills-ja/frontend-typescript-testing/SKILL.md +15 -71
- package/.claude/skills-ja/integration-e2e-testing/SKILL.md +2 -0
- package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +2 -7
- package/.claude/skills-ja/task-analyzer/references/skills-index.yaml +10 -11
- package/CHANGELOG.md +19 -0
- package/package.json +1 -1
|
@@ -29,31 +29,7 @@ ADR/Design Docの作成閾値はdocumentation-criteriaスキルに準拠。判
|
|
|
29
29
|
|
|
30
30
|
### ゲート順序 [BLOCKING]
|
|
31
31
|
|
|
32
|
-
以下のサブセクションは並列の必須事項ではなく、4
|
|
33
|
-
|
|
34
|
-
**Gate 0 — Inputs and Standards**(上流依存なし):
|
|
35
|
-
- Agreement Checklist
|
|
36
|
-
- Standards Identification
|
|
37
|
-
|
|
38
|
-
**Gate 1 — Existing State Analysis**(Gate 0 に依存):
|
|
39
|
-
- Existing Code Investigation
|
|
40
|
-
- Fact Disposition(Codebase Analysis 入力が提供される場合)
|
|
41
|
-
- Data Representation Decision(新規または変更されるデータ構造を導入する場合)
|
|
42
|
-
- Minimal Surface Alternatives(永続状態、公開コントラクト要素または境界を越えるフィールド、振る舞いモード/フラグ、再利用可能な抽象を導入する場合)
|
|
43
|
-
|
|
44
|
-
**Gate 2 — Design Decisions**(Gate 1 に依存):
|
|
45
|
-
- Implementation Approach Decision
|
|
46
|
-
- Common ADR Process
|
|
47
|
-
- Data Contracts
|
|
48
|
-
- State Transitions(該当する場合)
|
|
49
|
-
|
|
50
|
-
**Gate 3 — Impact Documentation**(Gate 2 に依存):
|
|
51
|
-
- Integration Points
|
|
52
|
-
- Change Impact Map
|
|
53
|
-
- Field Propagation Map(フィールドがコンポーネント境界を越える場合)
|
|
54
|
-
- Interface Change Impact Analysis
|
|
55
|
-
|
|
56
|
-
各サブセクションには見出しに `[Gate N — ...]` の注記を付す。サブセクションはゲート順(Gate 0 → 1 → 2 → 3)で記載されており、文書順に実行すること。
|
|
32
|
+
以下のサブセクションは並列の必須事項ではなく、4段階の直列ゲートを構成する: **Gate 0** Inputs & Standards → **Gate 1** Existing-State Analysis → **Gate 2** Design Decisions → **Gate 3** Impact Documentation。各ゲートを完了してから次のゲートに進むこと。各サブセクションには見出しに `[Gate N — ...]` の注記(適用条件を含む)が付き、ゲート順に記載されている。文書順に実行すること。
|
|
57
33
|
|
|
58
34
|
### 合意事項チェックリスト [Gate 0 — Required]
|
|
59
35
|
Design Doc作成の最初に必ず実施:
|
|
@@ -370,6 +346,14 @@ Design Doc作成時に必ず含める:
|
|
|
370
346
|
|
|
371
347
|
## 受け入れ基準作成ガイドライン
|
|
372
348
|
|
|
349
|
+
### 価値起点のドラフトと境界拡張
|
|
350
|
+
|
|
351
|
+
各ACは価値起点でドラフトし、下記のルールを適用する前に要件境界へ展開する:
|
|
352
|
+
|
|
353
|
+
1. **価値起点**: まずユーザー/オペレーター/保守者にとっての価値を挙げ、次にそれを実現する観測可能な振る舞い、最後にそれを支える技術的境界を特定する。
|
|
354
|
+
2. **境界への展開**(候補抽出 — 採否は下記ルールが決定): ある振る舞いはメインパスでは成立しつつ、別の次元で退行しうる。振る舞いを変えるACごとに、約束した振る舞いが成立すべき箇所すべてでACを検討する — 単一/最新/全件のコレクション、同一サーフェス上の隣接フィールド、後続のライフサイクル状態やリトライ、stale/欠損/空の値、リフレッシュ失敗やフォールバック不在、権限/バリデーション/ポリシーの境界、入力スコープと選択/順序/識別キー、副作用、公開・可視性の境界(状態が別プロセス・コンポーネント・ユーザー・後続ステップから観測可能になる箇所)。
|
|
355
|
+
3. **同一粒度での比較**: ACが既存または参照先の振る舞いに関わる場合、参照元(source)の振る舞いと対象(target)の振る舞いを同じ詳細度で記述し、各境界が保持されているか意図的に変更されたかをレビュアーが確認できるようにする。
|
|
356
|
+
|
|
373
357
|
### 測定可能なACの書き方
|
|
374
358
|
|
|
375
359
|
**原則**: AC = 独立した環境で検証可能かつユーザーが観測可能な振る舞い。正常系・異常系・エッジケースをカバー。非機能要件(パフォーマンス、信頼性、スケーラビリティ)は別の「非機能要件」セクションで定義する。
|
|
@@ -55,7 +55,7 @@ fixture-e2e gap:
|
|
|
55
55
|
AND e2eAbsenceReason.fixtureE2eが伝達されていない
|
|
56
56
|
AND Design DocまたはUI Specにユーザー向けマルチステップジャーニーが含まれる
|
|
57
57
|
THEN 作業計画書ヘッダーに追記:
|
|
58
|
-
|
|
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
|
-
|
|
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
|
-
###
|
|
21
|
+
### Work Plan Resolution
|
|
22
22
|
|
|
23
|
-
Before any task processing, locate the work plan
|
|
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
|
|
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
|
|
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
|
|
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 —
|
|
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
|
-
###
|
|
21
|
+
### Work Plan Resolution
|
|
22
22
|
|
|
23
|
-
Before any task processing, locate the work plan
|
|
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
|
|
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,
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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,
|
|
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. **
|
|
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. **
|
|
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
|
-
- [ ]
|
|
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
|
-
|
|
47
|
-
|
|
48
|
-
|
|
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
|
-
###
|
|
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** を計算する —
|
|
56
|
+
本実行で消費する **Consumed Task Set** を計算する — 本レシピが所有・実行・後で削除する正確なファイル群。作業計画書の解決と同じ消費可能パターンを使用する:
|
|
66
57
|
|
|
67
|
-
1.
|
|
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 を確認し、適切な対応を決定する。注:
|
|
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
|
|
71
|
+
| タスクなし + 計画書を自動解決 | Consumed Task Set が空かつ計画書が自動解決(作業計画書の解決の Step 6 経由)で得られ、backend 信号 ≥1 かつ frontend 信号 = 0 が確認済み | ユーザーに確認 → task-decomposer実行(Step 6 のレイヤー検証で frontend / 不確定な計画は既に除外されているため安全) |
|
|
81
72
|
|
|
82
|
-
Design Doc から作業計画書がまだない状態で着手したい場合は、先に計画レシピを実行して計画書を生成してから本レシピを再起動する —
|
|
73
|
+
Design Doc から作業計画書がまだない状態で着手したい場合は、先に計画レシピを実行して計画書を生成してから本レシピを再起動する — 上記の作業計画書の解決は意図的に自動生成を行わず、レイヤー判断を明示的に保つ。
|
|
83
74
|
|
|
84
75
|
## タスク分解フェーズ(条件付き実行)
|
|
85
76
|
|
|
@@ -18,9 +18,9 @@ description: フロントエンド実装を自律実行モードで実行
|
|
|
18
18
|
|
|
19
19
|
## 実行前提条件
|
|
20
20
|
|
|
21
|
-
###
|
|
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.
|
|
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`
|
|
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
|
-
##
|
|
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
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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.
|
|
120
|
+
2. **作業計画書に Phase 0 完了を記録する**: コミットした各 Phase 0 解消タスクについて、作業計画書の Phase 0 セクションのチェックボックスを `[x]` にし、コミット済みである旨を注記する(` — committed` を付す)。これにより完了結果が計画書に残り、下流の task-decomposer がコミット済みの Phase 0 を再生成・再実行せずスキップできる。
|
|
123
121
|
|
|
124
|
-
3.
|
|
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
|
-
- [ ]
|
|
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
|
-
|
|
47
|
-
|
|
48
|
-
|
|
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):
|
|
@@ -17,10 +17,10 @@ TypeScript-based React application implementation. Architecture patterns should
|
|
|
17
17
|
- Properly implement default value settings and mandatory checks
|
|
18
18
|
|
|
19
19
|
```typescript
|
|
20
|
-
// Build tool environment variables (public values only)
|
|
20
|
+
// Build tool environment variables (public values only; client-exposed vars need the VITE_ prefix)
|
|
21
21
|
const config = {
|
|
22
|
-
apiUrl: import.meta.env.
|
|
23
|
-
appName: import.meta.env.
|
|
22
|
+
apiUrl: import.meta.env.VITE_API_URL || 'http://localhost:3000',
|
|
23
|
+
appName: import.meta.env.VITE_APP_NAME || 'My App'
|
|
24
24
|
}
|
|
25
25
|
|
|
26
26
|
// Does not work in frontend
|
|
@@ -37,7 +37,7 @@ const apiUrl = process.env.API_URL
|
|
|
37
37
|
**Correct Approach for Secrets**:
|
|
38
38
|
```typescript
|
|
39
39
|
// Security risk: API key exposed in browser
|
|
40
|
-
const apiKey = import.meta.env.
|
|
40
|
+
const apiKey = import.meta.env.VITE_API_KEY
|
|
41
41
|
const response = await fetch(`https://api.example.com/data?key=${apiKey}`)
|
|
42
42
|
|
|
43
43
|
// Correct: Backend manages secrets, frontend accesses via proxy
|