create-ai-project 1.14.10 → 1.14.11
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.
|
@@ -7,19 +7,18 @@ description: Add integration/E2E tests to existing backend codebase using Design
|
|
|
7
7
|
|
|
8
8
|
**Scope**: Backend only (acceptance-test-generator supports backend only)
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
**Role**: Orchestrator
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
- Test
|
|
16
|
-
-
|
|
17
|
-
|
|
18
|
-
Orchestrator invokes sub-agents and passes structured JSON between them.
|
|
12
|
+
**Execution Method**:
|
|
13
|
+
- Skeleton generation -> delegate to acceptance-test-generator
|
|
14
|
+
- Task file creation -> orchestrator creates directly
|
|
15
|
+
- Test implementation -> delegate to task-executor
|
|
16
|
+
- Test review -> delegate to integration-test-reviewer
|
|
17
|
+
- Quality checks -> delegate to quality-fixer
|
|
19
18
|
|
|
20
19
|
Design Doc path: $ARGUMENTS
|
|
21
20
|
|
|
22
|
-
**
|
|
21
|
+
**TodoWrite**: Register steps and update as each completes.
|
|
23
22
|
|
|
24
23
|
## Prerequisites
|
|
25
24
|
- Design Doc must exist (created manually or via reverse-engineer)
|
|
@@ -27,48 +26,91 @@ Design Doc path: $ARGUMENTS
|
|
|
27
26
|
|
|
28
27
|
## Execution Flow
|
|
29
28
|
|
|
30
|
-
### 1. Validate Design Doc
|
|
29
|
+
### 1. Validate Design Doc (Orchestrator)
|
|
31
30
|
```bash
|
|
32
31
|
# Verify Design Doc exists
|
|
33
32
|
ls $ARGUMENTS || ls docs/design/*.md | grep -v template | tail -1
|
|
34
33
|
```
|
|
35
34
|
|
|
36
|
-
### 2.
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
-
|
|
35
|
+
### 2. Skeleton Generation
|
|
36
|
+
|
|
37
|
+
**Task tool invocation**:
|
|
38
|
+
```
|
|
39
|
+
subagent_type: acceptance-test-generator
|
|
40
|
+
prompt: |
|
|
41
|
+
Generate test skeletons from Design Doc.
|
|
42
|
+
|
|
43
|
+
Design Doc: [path from Step 1]
|
|
44
|
+
|
|
45
|
+
Output:
|
|
46
|
+
- Integration test skeletons (*.int.test.ts)
|
|
47
|
+
- E2E test skeletons if applicable (*.e2e.test.ts)
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
**Expected output**: `generatedFiles` containing integration and e2e paths
|
|
51
|
+
|
|
52
|
+
### 3. Create Task File (Orchestrator)
|
|
41
53
|
|
|
42
|
-
### 3. Create Task File
|
|
43
54
|
Create task file following task template (see documentation-criteria skill):
|
|
44
55
|
- Path: `docs/plans/tasks/integration-tests-YYYYMMDD.md`
|
|
45
56
|
- Content: Test implementation tasks based on generated skeletons
|
|
46
|
-
- Include skeleton file paths in Target Files section
|
|
47
|
-
|
|
48
|
-
### 4.
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
57
|
+
- Include skeleton file paths from Step 2 output in Target Files section
|
|
58
|
+
|
|
59
|
+
### 4. Test Implementation
|
|
60
|
+
|
|
61
|
+
**Task tool invocation**:
|
|
62
|
+
```
|
|
63
|
+
subagent_type: task-executor
|
|
64
|
+
prompt: |
|
|
65
|
+
Implement tests following the task file.
|
|
66
|
+
|
|
67
|
+
Task file: docs/plans/tasks/integration-tests-YYYYMMDD.md
|
|
68
|
+
|
|
69
|
+
Requirements:
|
|
70
|
+
- Follow TDD principles (Red-Green-Refactor)
|
|
71
|
+
- Implement each skeleton test case
|
|
72
|
+
- Run tests and verify they pass
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**Expected output**: `status`, `testsAdded`
|
|
76
|
+
|
|
77
|
+
### 5. Test Review
|
|
78
|
+
|
|
79
|
+
**Task tool invocation**:
|
|
80
|
+
```
|
|
81
|
+
subagent_type: integration-test-reviewer
|
|
82
|
+
prompt: |
|
|
83
|
+
Review test quality.
|
|
84
|
+
|
|
85
|
+
Test files: [paths from Step 2 generatedFiles]
|
|
86
|
+
Skeleton files: [original skeleton paths]
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
**Expected output**: `status` (approved/needs_revision), `requiredFixes`
|
|
90
|
+
|
|
91
|
+
**Flow control**:
|
|
92
|
+
- `status: needs_revision` -> Return to Step 4 with `requiredFixes`
|
|
93
|
+
- `status: approved` -> Proceed to Step 6
|
|
94
|
+
|
|
95
|
+
### 6. Quality Check
|
|
96
|
+
|
|
97
|
+
**Task tool invocation**:
|
|
98
|
+
```
|
|
99
|
+
subagent_type: quality-fixer
|
|
100
|
+
prompt: |
|
|
101
|
+
Final quality assurance for test files.
|
|
102
|
+
|
|
103
|
+
Scope: Test files added in this workflow
|
|
104
|
+
|
|
105
|
+
Requirements:
|
|
106
|
+
- Run all tests
|
|
107
|
+
- Verify coverage meets requirements
|
|
108
|
+
- Fix any quality issues
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
**Expected output**: `approved` (true/false)
|
|
112
|
+
|
|
113
|
+
### 7. Commit (Orchestrator)
|
|
114
|
+
|
|
115
|
+
On `approved: true` from quality-fixer:
|
|
116
|
+
- Commit test files with appropriate message using Bash
|
|
@@ -7,19 +7,18 @@ description: Design Docを使用して既存バックエンドコードベース
|
|
|
7
7
|
|
|
8
8
|
**スコープ**: バックエンドのみ(acceptance-test-generatorはバックエンドのみ対応)
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
**Role**: オーケストレーター
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
|
|
18
|
-
オーケストレーターがサブエージェントを呼び出し、構造化JSONを受け渡す。
|
|
12
|
+
**実行方法**:
|
|
13
|
+
- スケルトン生成 → acceptance-test-generatorに委譲
|
|
14
|
+
- タスクファイル作成 → オーケストレーターが直接作成
|
|
15
|
+
- テスト実装 → task-executorに委譲
|
|
16
|
+
- テストレビュー → integration-test-reviewerに委譲
|
|
17
|
+
- 品質チェック → quality-fixerに委譲
|
|
19
18
|
|
|
20
19
|
Design Docパス: $ARGUMENTS
|
|
21
20
|
|
|
22
|
-
**
|
|
21
|
+
**TodoWrite登録**: 各ステップを登録し、完了時に更新。
|
|
23
22
|
|
|
24
23
|
## 前提条件
|
|
25
24
|
- Design Docが存在すること(手動またはreverse-engineerで作成)
|
|
@@ -27,48 +26,91 @@ Design Docパス: $ARGUMENTS
|
|
|
27
26
|
|
|
28
27
|
## 実行フロー
|
|
29
28
|
|
|
30
|
-
### 1. Design Doc
|
|
29
|
+
### 1. Design Doc検証(オーケストレーター)
|
|
31
30
|
```bash
|
|
32
31
|
# Design Docの存在確認
|
|
33
32
|
ls $ARGUMENTS || ls docs/design/*.md | grep -v template | tail -1
|
|
34
33
|
```
|
|
35
34
|
|
|
36
|
-
### 2.
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
-
|
|
35
|
+
### 2. スケルトン生成
|
|
36
|
+
|
|
37
|
+
**Taskツールでの呼び出し**:
|
|
38
|
+
```
|
|
39
|
+
subagent_type: acceptance-test-generator
|
|
40
|
+
prompt: |
|
|
41
|
+
Design Docからテストスケルトンを生成。
|
|
42
|
+
|
|
43
|
+
Design Doc: [ステップ1のパス]
|
|
44
|
+
|
|
45
|
+
出力:
|
|
46
|
+
- 統合テストスケルトン (*.int.test.ts)
|
|
47
|
+
- 該当する場合はE2Eテストスケルトン (*.e2e.test.ts)
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
**期待される出力**: `generatedFiles`(統合テストとE2Eのパスを含む)
|
|
51
|
+
|
|
52
|
+
### 3. タスクファイル作成(オーケストレーター)
|
|
41
53
|
|
|
42
|
-
### 3. タスクファイル作成
|
|
43
54
|
タスクテンプレートに従ってタスクファイルを作成(documentation-criteriaスキル参照):
|
|
44
55
|
- パス: `docs/plans/tasks/integration-tests-YYYYMMDD.md`
|
|
45
56
|
- 内容: 生成されたスケルトンに基づくテスト実装タスク
|
|
46
|
-
-
|
|
47
|
-
|
|
48
|
-
### 4.
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
57
|
+
- 対象ファイルセクションにステップ2の出力からスケルトンファイルパスを含める
|
|
58
|
+
|
|
59
|
+
### 4. テスト実装
|
|
60
|
+
|
|
61
|
+
**Taskツールでの呼び出し**:
|
|
62
|
+
```
|
|
63
|
+
subagent_type: task-executor
|
|
64
|
+
prompt: |
|
|
65
|
+
タスクファイルに従ってテストを実装。
|
|
66
|
+
|
|
67
|
+
タスクファイル: docs/plans/tasks/integration-tests-YYYYMMDD.md
|
|
68
|
+
|
|
69
|
+
要件:
|
|
70
|
+
- TDD原則に従う(Red-Green-Refactor)
|
|
71
|
+
- 各スケルトンテストケースを実装
|
|
72
|
+
- テストを実行してパスを確認
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**期待される出力**: `status`, `testsAdded`
|
|
76
|
+
|
|
77
|
+
### 5. テストレビュー
|
|
78
|
+
|
|
79
|
+
**Taskツールでの呼び出し**:
|
|
80
|
+
```
|
|
81
|
+
subagent_type: integration-test-reviewer
|
|
82
|
+
prompt: |
|
|
83
|
+
テスト品質をレビュー。
|
|
84
|
+
|
|
85
|
+
テストファイル: [ステップ2のgeneratedFilesのパス]
|
|
86
|
+
スケルトンファイル: [元のスケルトンパス]
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
**期待される出力**: `status` (approved/needs_revision), `requiredFixes`
|
|
90
|
+
|
|
91
|
+
**フロー制御**:
|
|
92
|
+
- `status: needs_revision` → `requiredFixes`と共にステップ4に戻る
|
|
93
|
+
- `status: approved` → ステップ6に進む
|
|
94
|
+
|
|
95
|
+
### 6. 品質チェック
|
|
96
|
+
|
|
97
|
+
**Taskツールでの呼び出し**:
|
|
98
|
+
```
|
|
99
|
+
subagent_type: quality-fixer
|
|
100
|
+
prompt: |
|
|
101
|
+
テストファイルの最終品質保証。
|
|
102
|
+
|
|
103
|
+
スコープ: このワークフローで追加されたテストファイル
|
|
104
|
+
|
|
105
|
+
要件:
|
|
106
|
+
- 全テストを実行
|
|
107
|
+
- カバレッジが要件を満たすことを確認
|
|
108
|
+
- 品質問題を修正
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
**期待される出力**: `approved` (true/false)
|
|
112
|
+
|
|
113
|
+
### 7. コミット(オーケストレーター)
|
|
114
|
+
|
|
115
|
+
quality-fixerから`approved: true`の場合:
|
|
116
|
+
- Bashで適切なメッセージを付けてテストファイルをコミット
|
|
@@ -6,14 +6,14 @@ description: 問題を調査し、検証を経て解決策を導出する
|
|
|
6
6
|
|
|
7
7
|
対象問題: $ARGUMENTS
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
**Role**: オーケストレーター
|
|
10
10
|
|
|
11
11
|
**実行方法**:
|
|
12
|
-
- 調査 → investigator
|
|
13
|
-
- 検証 → verifier
|
|
14
|
-
- 解決策導出 → solver
|
|
12
|
+
- 調査 → investigatorに委譲
|
|
13
|
+
- 検証 → verifierに委譲
|
|
14
|
+
- 解決策導出 → solverに委譲
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
オーケストレーターがサブエージェントを呼び出し、構造化JSONを受け渡します。
|
|
17
17
|
|
|
18
18
|
**TodoWrite登録**: 実行ステップをTodoWriteに登録し、計画的にタスクを進める
|
|
19
19
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-ai-project",
|
|
3
|
-
"version": "1.14.
|
|
3
|
+
"version": "1.14.11",
|
|
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": [
|