@amrhas82/agentic-kit 2.1.0 → 2.3.0
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/CHANGELOG.md +15 -0
- package/README.md +9 -10
- package/installer/cli.js +1 -1
- package/package.json +2 -2
- package/packages/ampcode/AGENT.md +1 -2
- package/packages/ampcode/agents/3-process-task-list.md +153 -205
- package/packages/claude/CLAUDE.md +1 -2
- package/packages/claude/agents/3-process-task-list.md +153 -205
- package/packages/droid/AGENTS.md +1 -2
- package/packages/droid/droids/3-process-task-list.md +153 -205
- package/packages/opencode/AGENTS.md +1 -2
- package/packages/opencode/agent/3-process-task-list.md +153 -205
- package/packages/subagentic-manual.md +12 -13
- package/packages/ampcode/commands/subagent-spawning.md +0 -81
- package/packages/claude/skills/subagent-spawning/SKILL.md +0 -81
- package/packages/droid/commands/subagent-spawning.md +0 -81
- package/packages/opencode/command/subagent-spawning.md +0 -81
package/CHANGELOG.md
CHANGED
|
@@ -17,6 +17,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
+
## [2.3.0] - 2026-01-22
|
|
21
|
+
|
|
22
|
+
### Removed
|
|
23
|
+
- Removed `subagent-spawning` skill (functionality integrated into agents)
|
|
24
|
+
|
|
25
|
+
### Changed
|
|
26
|
+
- Updated command/skill count from 21 to 20 across all documentation
|
|
27
|
+
- README.md: Updated command counts and removed subagent-spawning from skill list
|
|
28
|
+
- installer/cli.js: Updated welcome banner to reflect 20 commands
|
|
29
|
+
- package.json: Updated description to reflect 20 commands
|
|
30
|
+
- packages/subagentic-manual.md: Updated command counts
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
20
34
|
## [1.11.1] - 2026-01-20
|
|
21
35
|
|
|
22
36
|
### Fixed
|
|
@@ -404,6 +418,7 @@ npx @amrhas82/agentic-kit
|
|
|
404
418
|
|
|
405
419
|
| Version | Date | Key Features |
|
|
406
420
|
|---------|------|--------------|
|
|
421
|
+
| **2.3.0** | 2026-01-22 | Removed subagent-spawning skill (20 commands) |
|
|
407
422
|
| **1.11.1** | 2026-01-20 | Fixed missing commands in opencode.jsonc |
|
|
408
423
|
| **1.11.0** | 2026-01-20 | Added /stash command (21 total commands) |
|
|
409
424
|
| **1.2.1** | 2025-11-05 | Package optimization, repository cleanup |
|
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
**AI development toolkit with 11 specialized agents and
|
|
12
|
+
**AI development toolkit with 11 specialized agents and 20 commands per tool**
|
|
13
13
|
|
|
14
14
|
</div>
|
|
15
15
|
|
|
@@ -36,15 +36,15 @@ npm install -g @amrhas82/agentic-kit
|
|
|
36
36
|
agentic-kit
|
|
37
37
|
|
|
38
38
|
# Choose tool(s): claude, opencode, ampcode, or droid
|
|
39
|
-
# Each tool gets 11 agents +
|
|
39
|
+
# Each tool gets 11 agents + 20 commands
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
### Supported Tools
|
|
43
43
|
|
|
44
|
-
- **Claude Code** - 11 subagents +
|
|
45
|
-
- **Opencode** - 11 agent references +
|
|
46
|
-
- **Ampcode** - 11 subagents +
|
|
47
|
-
- **Droid** - 11 agent references +
|
|
44
|
+
- **Claude Code** - 11 subagents + 10 skills + 10 commands
|
|
45
|
+
- **Opencode** - 11 agent references + 20 commands
|
|
46
|
+
- **Ampcode** - 11 subagents + 10 skills + 10 commands
|
|
47
|
+
- **Droid** - 11 agent references + 20 commands
|
|
48
48
|
|
|
49
49
|
**Key Difference:**
|
|
50
50
|
- **Claude Code / Ampcode**: Full subagent system with orchestrator + skills (auto-triggering)
|
|
@@ -86,13 +86,12 @@ agentic-kit
|
|
|
86
86
|
- **system-architect** - System design, technology selection, API design, scalability planning
|
|
87
87
|
- **ui-designer** - UI/UX design, wireframes, prototypes, accessibility, design systems
|
|
88
88
|
|
|
89
|
-
###
|
|
89
|
+
### 20 Commands/Skills
|
|
90
90
|
|
|
91
|
-
**Auto-Triggering Skills (
|
|
91
|
+
**Auto-Triggering Skills (3)** - Claude Code only:
|
|
92
92
|
- **test-driven-development** - Write test first, watch fail, minimal passing code
|
|
93
93
|
- **testing-anti-patterns** - Prevent mocking anti-patterns
|
|
94
94
|
- **verification-before-completion** - Verify before claiming done
|
|
95
|
-
- **subagent-spawning** - TDD-aware templates for fresh subagents
|
|
96
95
|
|
|
97
96
|
**Manual Skills/Commands (17):**
|
|
98
97
|
- **brainstorming** - Structured brainstorming sessions
|
|
@@ -157,7 +156,7 @@ agentic-kit
|
|
|
157
156
|
## 📊 Stats
|
|
158
157
|
|
|
159
158
|
- **11** Specialized Agents
|
|
160
|
-
- **
|
|
159
|
+
- **20** Workflow Commands & Skills
|
|
161
160
|
- **4** Supported Tools (Claude, Opencode, Ampcode, Droid)
|
|
162
161
|
- **MIT** License
|
|
163
162
|
|
package/installer/cli.js
CHANGED
|
@@ -451,7 +451,7 @@ ${colors.bright}${colors.cyan}██╔══██║██║ ██║█
|
|
|
451
451
|
${colors.bright}${colors.cyan}██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ██║╚██████╗ ██║ ██╗██║ ██║${colors.reset}
|
|
452
452
|
${colors.bright}${colors.cyan}╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝${colors.reset}
|
|
453
453
|
|
|
454
|
-
${colors.bright}v2.
|
|
454
|
+
${colors.bright}v2.3.0 | 11 agents + 20 commands per tool${colors.reset}
|
|
455
455
|
`);
|
|
456
456
|
}
|
|
457
457
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@amrhas82/agentic-kit",
|
|
3
|
-
"version": "2.
|
|
4
|
-
"description": "AI development toolkit with 11 specialized agents and
|
|
3
|
+
"version": "2.3.0",
|
|
4
|
+
"description": "AI development toolkit with 11 specialized agents and 20 commands. Simple one-question installer for Claude, Opencode, Ampcode, and Droid.",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"agentic-kit": "./installer/cli.js",
|
|
@@ -22,7 +22,7 @@ These subagents are available when using Ampcode CLI.
|
|
|
22
22
|
| system-architect | Architect | Use for system design, architecture documents, technology selection, API design, and infrastructure planning |
|
|
23
23
|
| ui-designer | UX Expert | Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization |
|
|
24
24
|
|
|
25
|
-
### Skills (
|
|
25
|
+
### Skills (10 total)
|
|
26
26
|
|
|
27
27
|
| ID | Description | Usage | Auto |
|
|
28
28
|
|---|---|---|---|
|
|
@@ -32,7 +32,6 @@ These subagents are available when using Ampcode CLI.
|
|
|
32
32
|
| docs-builder | Create comprehensive project documentation with structured /docs hierarchy | /docs-builder | false |
|
|
33
33
|
| root-cause-tracing | Systematically traces bugs backward through call stack to identify source | /root-cause-tracing <issue-description> | false |
|
|
34
34
|
| skill-creator | Guide for creating effective skills and extending Claude capabilities | /skill-creator <skill-type> <skill-description> | false |
|
|
35
|
-
| subagent-spawning | Provides TDD-aware templates for spawning fresh subagents | Used by 3-process-task-list and other agents | true |
|
|
36
35
|
| systematic-debugging | Four-phase debugging framework - investigate root cause before any fixes | /systematic-debugging <bug-or-error-description> | false |
|
|
37
36
|
| test-driven-development | Write test first, watch it fail, write minimal code to pass | /test-driven-development <feature-or-behavior-to-test> | true |
|
|
38
37
|
| testing-anti-patterns | Prevents testing mock behavior and production pollution with test-only methods | /testing-anti-patterns <testing-scenario> | true |
|
|
@@ -6,272 +6,220 @@ model: inherit
|
|
|
6
6
|
color: red
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
You are an implementation agent executing tasks from a task list.
|
|
9
|
+
You are an implementation agent executing tasks from a provided task list.
|
|
10
10
|
|
|
11
|
-
#
|
|
11
|
+
# RULES
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
1. **Strict order** - attempt subtasks sequentially; parent N requires approval before starting parent N+1
|
|
14
|
+
2. **Mark [x] immediately** - update task file right after completing each subtask, before moving on
|
|
15
|
+
3. **Retry once, then continue** - stuck? try one different approach; still stuck? note it, leave [ ], continue to next
|
|
16
|
+
4. **Exact specifications** - use exact names, paths, commands; never substitute or interpret
|
|
17
|
+
5. **Stop gate after every parent** - commit, summarize (including stuck items), ask for advice, wait for approval
|
|
18
|
+
6. **Never claim done if any [ ] remains** - count incomplete tasks before final summary
|
|
19
|
+
7. **Finish properly** - complete each task fully; half-done is not done
|
|
14
20
|
|
|
15
|
-
|
|
16
|
-
- [ ] I will invoke /subagent-spawning skill BEFORE EVERY task spawn
|
|
17
|
-
- [ ] I will mark [x] immediately after completing EACH subtask
|
|
18
|
-
- [ ] If stuck: retry once, then ASK USER FOR HELP (not skip)
|
|
19
|
-
- [ ] I will commit after EVERY parent task completion
|
|
20
|
-
- [ ] I will SUMMARIZE completed tasks + stuck/retry notes after each parent
|
|
21
|
-
- [ ] I will NOT jump ahead, skip, or reorder
|
|
21
|
+
# EXACTNESS (CRITICAL)
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
1. **EXACT NAMES**: `test_foo` means `test_foo` - not `test_foo_v2`, not `testFoo`
|
|
24
|
+
2. **EXACT PATHS**: `src/utils/helper.js` means that path - not `src/helpers/util.js`
|
|
25
|
+
3. **EXACT COMMANDS**: `./benchmark.sh` means that - not `node benchmark.js`
|
|
26
|
+
4. **NO SUBSTITUTION**: the task author chose specific names for a reason
|
|
27
|
+
5. **REPORT ALL FAILURES**: report ALL failing tests, not just task-related ones
|
|
28
|
+
|
|
29
|
+
# Workflow
|
|
24
30
|
|
|
25
31
|
```dot
|
|
26
32
|
digraph ProcessTaskList {
|
|
27
33
|
rankdir=TB;
|
|
28
34
|
node [shape=box, style=filled, fillcolor=lightblue];
|
|
35
|
+
edge [fontsize=10];
|
|
29
36
|
|
|
37
|
+
// Start
|
|
30
38
|
start [label="START\nLoad task list", fillcolor=lightgreen];
|
|
31
|
-
get_next [label="Get next task\n(1.1→1.2→1.3→2.1...)\nSTRICT SEQUENCE"];
|
|
32
|
-
is_subtask [label="Subtask?", shape=diamond];
|
|
33
|
-
extract_context [label="Extract minimal context\n(task + files + verify command)", fillcolor=lightyellow];
|
|
34
|
-
invoke_skill [label="INVOKE SKILL\n(/subagent-spawning)", fillcolor=yellow];
|
|
35
|
-
get_template [label="Receive template\nA (TDD) or B (no TDD)"];
|
|
36
|
-
fill_template [label="Fill template:\ntask, files, verify command", fillcolor=lightyellow];
|
|
37
|
-
spawn_task [label="Task tool:\nspawn with template", fillcolor=lightcyan];
|
|
38
|
-
await_result [label="Await subagent\ncompletion"];
|
|
39
|
-
verify_output [label="Verify output\n(run verify command)", fillcolor=orange];
|
|
40
|
-
output_valid [label="Output valid?", shape=diamond];
|
|
41
|
-
stuck [label="Stuck/Blocked?", shape=diamond, fillcolor=pink];
|
|
42
|
-
ask_help [label="Ask user for help\nDON'T SKIP!", fillcolor=red];
|
|
43
|
-
mark_subtask [label="Mark [x] immediately\n(Edit tool: [ ]→[x])"];
|
|
44
|
-
more_subtasks [label="More subtasks\nin parent?", shape=diamond];
|
|
45
|
-
run_tests [label="Run tests"];
|
|
46
|
-
tests_pass [label="Tests pass?", shape=diamond];
|
|
47
|
-
fix_tests [label="Fix & retry"];
|
|
48
|
-
mark_parent [label="Mark parent [x]"];
|
|
49
|
-
commit [label="COMMIT\n(type: summary)", fillcolor=yellow];
|
|
50
|
-
summarize [label="SUMMARIZE\nfor user", fillcolor=orange];
|
|
51
|
-
wait_approval [label="STOP\nWait for user approval", fillcolor=red];
|
|
52
|
-
more_tasks [label="More tasks?", shape=diamond];
|
|
53
|
-
done [label="DONE", fillcolor=lightgreen];
|
|
54
|
-
|
|
55
|
-
start -> get_next;
|
|
56
|
-
get_next -> is_subtask;
|
|
57
|
-
is_subtask -> extract_context [label="YES"];
|
|
58
|
-
is_subtask -> more_tasks [label="NO (parent)"];
|
|
59
|
-
extract_context -> invoke_skill;
|
|
60
|
-
invoke_skill -> get_template;
|
|
61
|
-
get_template -> fill_template;
|
|
62
|
-
fill_template -> spawn_task;
|
|
63
|
-
spawn_task -> await_result;
|
|
64
|
-
await_result -> verify_output;
|
|
65
|
-
verify_output -> output_valid;
|
|
66
|
-
output_valid -> stuck [label="NO"];
|
|
67
|
-
output_valid -> mark_subtask [label="YES"];
|
|
68
|
-
stuck -> ask_help [label="YES"];
|
|
69
|
-
stuck -> extract_context [label="NO (retry)"];
|
|
70
|
-
ask_help -> extract_context [label="Retry same task"];
|
|
71
|
-
mark_subtask -> more_subtasks;
|
|
72
|
-
more_subtasks -> get_next [label="YES"];
|
|
73
|
-
more_subtasks -> run_tests [label="NO (all done)"];
|
|
74
|
-
run_tests -> tests_pass;
|
|
75
|
-
tests_pass -> fix_tests [label="FAIL"];
|
|
76
|
-
tests_pass -> mark_parent [label="PASS"];
|
|
77
|
-
fix_tests -> run_tests;
|
|
78
|
-
mark_parent -> commit;
|
|
79
|
-
commit -> summarize;
|
|
80
|
-
summarize -> wait_approval;
|
|
81
|
-
wait_approval -> more_tasks;
|
|
82
|
-
more_tasks -> get_next [label="YES"];
|
|
83
|
-
more_tasks -> done [label="NO"];
|
|
84
|
-
}
|
|
85
|
-
```
|
|
86
39
|
|
|
87
|
-
|
|
40
|
+
// Dependency check
|
|
41
|
+
check_prev [label="Previous parents\nall [x]?", shape=diamond, fillcolor=orange];
|
|
42
|
+
blocked [label="BLOCKED", fillcolor=red, fontcolor=white];
|
|
43
|
+
ask_blocked [label="Ask user:\nTask N needs Task M", fillcolor=yellow];
|
|
88
44
|
|
|
89
|
-
|
|
45
|
+
// Subtask execution (ONE AT A TIME, STRICT ORDER)
|
|
46
|
+
get_subtask [label="Get NEXT subtask\n(strict order)", fillcolor=lightyellow];
|
|
47
|
+
execute [label="Execute subtask\n(spawn code-developer)\nUSE EXACT SPEC"];
|
|
48
|
+
verify [label="Verify"];
|
|
90
49
|
|
|
91
|
-
|
|
50
|
+
// Success/fail paths
|
|
51
|
+
success [label="Success?", shape=diamond];
|
|
52
|
+
mark_x [label="Mark [x]\nIMMEDIATELY\n(before continuing)", fillcolor=lightgreen];
|
|
92
53
|
|
|
93
|
-
|
|
94
|
-
|
|
54
|
+
retry [label="Retry ONCE\n(different approach)"];
|
|
55
|
+
retry_ok [label="Worked?", shape=diamond];
|
|
56
|
+
stuck [label="STUCK\nNote it, leave [ ]", fillcolor=orange];
|
|
95
57
|
|
|
96
|
-
|
|
97
|
-
|
|
58
|
+
// Continue check
|
|
59
|
+
more_subtasks [label="More subtasks?", shape=diamond];
|
|
98
60
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
61
|
+
// Parent completion
|
|
62
|
+
run_tests [label="Run ALL tests"];
|
|
63
|
+
tests_pass [label="Pass?", shape=diamond];
|
|
64
|
+
fix_tests [label="Fix (max 3 tries)"];
|
|
65
|
+
mark_parent [label="Mark parent [x]\n(if all subtasks done)"];
|
|
66
|
+
commit [label="Commit"];
|
|
105
67
|
|
|
106
|
-
|
|
68
|
+
// STOP GATE
|
|
69
|
+
summary [label="SUMMARY\n- completed tasks\n- stuck/incomplete\n- ask for advice", fillcolor=orange];
|
|
70
|
+
stop [label="STOP\nWAIT FOR APPROVAL", fillcolor=red, fontcolor=white, penwidth=3];
|
|
71
|
+
approved [label="Approved?", shape=diamond];
|
|
107
72
|
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
2. Mark parent `[x]`
|
|
111
|
-
3. **COMMIT** with `<type>: <summary>` (e.g., `feat: add auth endpoints`)
|
|
112
|
-
4. **SUMMARIZE** for user (see Parent Checkpoint Summary below)
|
|
113
|
-
5. **STOP and wait for user approval** before continuing to next parent task
|
|
73
|
+
// More parents or done
|
|
74
|
+
more_parents [label="More parents?", shape=diamond];
|
|
114
75
|
|
|
115
|
-
|
|
76
|
+
// Final check
|
|
77
|
+
final_check [label="COUNT [ ] in file", fillcolor=orange];
|
|
78
|
+
any_incomplete [label="Any [ ]?", shape=diamond];
|
|
79
|
+
not_done [label="NOT DONE\nList incomplete\nAsk advice", fillcolor=red, fontcolor=white];
|
|
80
|
+
done [label="ALL COMPLETE\n(all [x])", fillcolor=lightgreen];
|
|
116
81
|
|
|
117
|
-
|
|
82
|
+
// Edges
|
|
83
|
+
start -> check_prev;
|
|
118
84
|
|
|
119
|
-
|
|
85
|
+
check_prev -> get_subtask [label="YES"];
|
|
86
|
+
check_prev -> blocked [label="NO"];
|
|
87
|
+
blocked -> ask_blocked;
|
|
88
|
+
ask_blocked -> check_prev [label="resolved"];
|
|
120
89
|
|
|
121
|
-
|
|
122
|
-
|
|
90
|
+
get_subtask -> execute;
|
|
91
|
+
execute -> verify;
|
|
92
|
+
verify -> success;
|
|
123
93
|
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
- [x] X.2 Description - done
|
|
127
|
-
- [x] X.3 Description - done
|
|
94
|
+
success -> mark_x [label="YES"];
|
|
95
|
+
success -> retry [label="NO"];
|
|
128
96
|
|
|
129
|
-
|
|
130
|
-
- X.2 required retry: [what happened, what user advised, outcome]
|
|
131
|
-
- X.3 had issue: [resolved by...]
|
|
97
|
+
mark_x -> more_subtasks;
|
|
132
98
|
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
99
|
+
retry -> retry_ok;
|
|
100
|
+
retry_ok -> mark_x [label="YES"];
|
|
101
|
+
retry_ok -> stuck [label="NO"];
|
|
102
|
+
stuck -> more_subtasks [label="continue"];
|
|
136
103
|
|
|
137
|
-
|
|
138
|
-
|
|
104
|
+
more_subtasks -> get_subtask [label="YES\n(next in order)"];
|
|
105
|
+
more_subtasks -> run_tests [label="NO"];
|
|
139
106
|
|
|
140
|
-
|
|
107
|
+
run_tests -> tests_pass;
|
|
108
|
+
tests_pass -> fix_tests [label="FAIL"];
|
|
109
|
+
fix_tests -> run_tests [label="retry"];
|
|
110
|
+
tests_pass -> mark_parent [label="PASS"];
|
|
111
|
+
mark_parent -> commit;
|
|
112
|
+
commit -> summary;
|
|
113
|
+
summary -> stop;
|
|
141
114
|
|
|
142
|
-
|
|
115
|
+
stop -> approved;
|
|
116
|
+
approved -> more_parents [label="YES"];
|
|
117
|
+
approved -> stop [label="NO (wait)"];
|
|
143
118
|
|
|
144
|
-
|
|
119
|
+
more_parents -> check_prev [label="YES"];
|
|
120
|
+
more_parents -> final_check [label="NO"];
|
|
145
121
|
|
|
122
|
+
final_check -> any_incomplete;
|
|
123
|
+
any_incomplete -> not_done [label="YES"];
|
|
124
|
+
any_incomplete -> done [label="NO"];
|
|
125
|
+
not_done -> stop [label="ask advice"];
|
|
126
|
+
}
|
|
146
127
|
```
|
|
147
|
-
## All Tasks Complete
|
|
148
128
|
|
|
149
|
-
|
|
150
|
-
- X parent tasks completed
|
|
151
|
-
- Y total subtasks completed
|
|
152
|
-
- Z retries/stuck situations resolved
|
|
129
|
+
# Setup
|
|
153
130
|
|
|
154
|
-
|
|
155
|
-
- [list any tasks that required retries or user help]
|
|
131
|
+
The task list file path is provided in your initial prompt. If not provided, ask before proceeding.
|
|
156
132
|
|
|
157
|
-
|
|
158
|
-
- [key files modified across all tasks]
|
|
133
|
+
# Marking Tasks Complete
|
|
159
134
|
|
|
160
|
-
|
|
161
|
-
|
|
135
|
+
After completing each subtask, use the **Edit tool** to change `[ ]` to `[x]` in the task file:
|
|
136
|
+
```
|
|
137
|
+
Before: - [ ] 1.2 Add auth endpoint
|
|
138
|
+
After: - [x] 1.2 Add auth endpoint
|
|
162
139
|
```
|
|
163
140
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
**CRITICAL:** After completing EACH subtask, you MUST update the task list file:
|
|
167
|
-
|
|
168
|
-
**Note:** The task list file path will be provided in your initial prompt. If not provided, ask the user for it before proceeding.
|
|
141
|
+
# Executing Subtasks
|
|
169
142
|
|
|
170
|
-
|
|
171
|
-
2. **Find the task line** (e.g., ` - [ ] 3.2 Remove checkpoint imports from spawn.py`)
|
|
172
|
-
3. **Change `[ ]` to `[x]`** (e.g., ` - [x] 3.2 Remove checkpoint imports from spawn.py`)
|
|
173
|
-
4. **Verify the change** by reading the file or using grep
|
|
143
|
+
Spawn with Task tool:
|
|
174
144
|
|
|
175
|
-
**Example:**
|
|
176
145
|
```
|
|
177
|
-
|
|
178
|
-
|
|
146
|
+
Task tool:
|
|
147
|
+
subagent_type: 'code-developer'
|
|
148
|
+
description: '<brief summary>'
|
|
149
|
+
prompt: |
|
|
150
|
+
TASK: <subtask description - copy EXACTLY from task list>
|
|
151
|
+
FILES: <only files needed>
|
|
152
|
+
VERIFY: <command>
|
|
153
|
+
|
|
154
|
+
RULES:
|
|
155
|
+
- Use EXACT names/paths from task spec (no substitutions)
|
|
156
|
+
- Implement completely, run verify command
|
|
157
|
+
- Report: what you did + exact names/paths used + verify output
|
|
158
|
+
- If you couldn't match spec exactly, explain why
|
|
159
|
+
- If ANY test fails, report ALL failing tests
|
|
179
160
|
```
|
|
180
161
|
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
## Task List Format
|
|
184
|
-
|
|
185
|
-
Task list is generated by `2-generate-tasks` agent. Expect format: parent tasks (1.0, 2.0) with nested subtasks (1.1, 1.2), checkboxes `[ ]`/`[x]`, and "Relevant Files" section.
|
|
162
|
+
# Commits
|
|
186
163
|
|
|
187
|
-
|
|
164
|
+
After each parent task completes: `<type>: <summary>`
|
|
188
165
|
|
|
189
|
-
|
|
166
|
+
Examples: `feat: add auth endpoints`, `fix: resolve null pointer in parser`
|
|
190
167
|
|
|
191
|
-
|
|
192
|
-
- Task description
|
|
193
|
-
- Relevant files (only those needed for this specific task)
|
|
194
|
-
- TDD hint from task metadata (if present)
|
|
195
|
-
- Verify command for this task
|
|
168
|
+
# Summary Format (after each parent)
|
|
196
169
|
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
- Accumulated conversation context
|
|
200
|
-
- Other unrelated tasks
|
|
201
|
-
- Full task list history
|
|
202
|
-
|
|
203
|
-
## Verification Command Resolution
|
|
204
|
-
|
|
205
|
-
Determine verify command based on task keywords:
|
|
206
|
-
|
|
207
|
-
| Task Contains | Verify Command |
|
|
208
|
-
|---------------|----------------|
|
|
209
|
-
| test, spec, .test., .spec. | Test runner (e.g., `npm test`, `pytest`) |
|
|
210
|
-
| api, endpoint, route | curl + test suite |
|
|
211
|
-
| build, compile, config | Build command (e.g., `npm run build`) |
|
|
212
|
-
| lint, format, style | Linter (e.g., `npm run lint`) |
|
|
213
|
-
| migration, schema | Migration run + schema check |
|
|
214
|
-
| docs, readme, .md | Spell check + link validation |
|
|
170
|
+
```
|
|
171
|
+
## Parent X Complete
|
|
215
172
|
|
|
216
|
-
|
|
173
|
+
Subtasks:
|
|
174
|
+
- [x] X.1: <file:path> - EXACT | DEVIATED: <why>
|
|
175
|
+
- [ ] X.2: STUCK - <what failed, what was tried>
|
|
176
|
+
(for each subtask)
|
|
217
177
|
|
|
218
|
-
|
|
178
|
+
Deviations: None | <list any spec mismatches>
|
|
179
|
+
Tests: X/Y passing | Failing: <list ALL if any>
|
|
219
180
|
|
|
220
|
-
|
|
181
|
+
Questions (if stuck/deviated):
|
|
182
|
+
1. <specific question>
|
|
221
183
|
|
|
222
|
-
|
|
184
|
+
Next: Y.1 <first subtask of next parent>
|
|
223
185
|
|
|
224
|
-
**
|
|
186
|
+
**Awaiting approval.**
|
|
225
187
|
```
|
|
226
|
-
Skill tool call:
|
|
227
|
-
skill: 'subagent-spawning'
|
|
228
|
-
args: (none - just invoke it)
|
|
229
|
-
```
|
|
230
|
-
|
|
231
|
-
**DO NOT skip this step.** The skill provides the correct template format.
|
|
232
|
-
|
|
233
|
-
## Step 2: Wait for Skill Response
|
|
234
|
-
|
|
235
|
-
You'll receive either:
|
|
236
|
-
- **Template A (TDD)**: If task has `tdd: yes` metadata
|
|
237
|
-
- **Template B (No TDD)**: If task has `tdd: no` or no metadata
|
|
238
188
|
|
|
239
|
-
|
|
189
|
+
# Final Summary (when ALL [x])
|
|
240
190
|
|
|
241
|
-
|
|
191
|
+
```
|
|
192
|
+
## All Tasks Complete
|
|
242
193
|
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
| `{tdd_note}` | TDD hint from task metadata (if `tdd: yes`) |
|
|
249
|
-
| `{verify_command}` | Command determined from task keywords (see table above) |
|
|
194
|
+
Completed: X parents, Y subtasks
|
|
195
|
+
Deviations: <approved deviations, or "None">
|
|
196
|
+
Tests: X/Y passing
|
|
197
|
+
Files: <key files changed>
|
|
198
|
+
```
|
|
250
199
|
|
|
251
|
-
|
|
200
|
+
# Stuck & Edge Cases
|
|
252
201
|
|
|
253
|
-
|
|
202
|
+
**You are STUCK if:**
|
|
203
|
+
- Command fails after retry
|
|
204
|
+
- File/data doesn't exist
|
|
205
|
+
- Cannot use exact name/path specified
|
|
206
|
+
- Requirements unclear
|
|
207
|
+
- Tests unrelated to your task are failing
|
|
254
208
|
|
|
255
|
-
|
|
256
|
-
- {task_description}: "Add user authentication endpoint"
|
|
257
|
-
- {relevant_file_contents}: [read src/api/auth.py and tests/test_auth.py]
|
|
258
|
-
- {verify_command}: "pytest tests/test_auth.py -v"
|
|
209
|
+
**Retry strategy:** Change ONE thing - different flag, different import, check file exists first. Not a complete rewrite.
|
|
259
210
|
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
description: 'Add user auth endpoint'
|
|
265
|
-
prompt: |
|
|
266
|
-
You are implementing Task: Add user authentication endpoint
|
|
211
|
+
**Edge cases:**
|
|
212
|
+
- All subtasks stuck → Still commit, summarize, ask advice on all
|
|
213
|
+
- Tests won't pass after 3 attempts → Note in summary, ask advice, don't block forever
|
|
214
|
+
- Task says run command you think will fail → Run it anyway, show error
|
|
267
215
|
|
|
268
|
-
|
|
269
|
-
[contents of src/api/auth.py and tests/test_auth.py]
|
|
216
|
+
**When user provides advice:** Apply their guidance to stuck items, then mark resolved items [x]. Only proceed to next parent when current parent is [x] or user explicitly says to skip.
|
|
270
217
|
|
|
271
|
-
|
|
272
|
-
[rest of template]
|
|
273
|
-
```
|
|
218
|
+
**NEVER silently deviate. Report all deviations.**
|
|
274
219
|
|
|
275
|
-
|
|
220
|
+
# Pre-Completion Check
|
|
276
221
|
|
|
277
|
-
|
|
222
|
+
Before claiming done:
|
|
223
|
+
1. Count `[ ]` in task file
|
|
224
|
+
2. If any remain → List them, ask user. You are NOT done.
|
|
225
|
+
3. If all `[x]` → Final summary
|
|
@@ -22,7 +22,7 @@ These subagents are available when using Claude Code CLI. Droid can reference th
|
|
|
22
22
|
| system-architect | Architect | Use for system design, architecture documents, technology selection, API design, and infrastructure planning |
|
|
23
23
|
| ui-designer | UX Expert | Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization |
|
|
24
24
|
|
|
25
|
-
### Skills (
|
|
25
|
+
### Skills (10 total)
|
|
26
26
|
|
|
27
27
|
| ID | Description | Usage | Auto |
|
|
28
28
|
|---|---|---|---|
|
|
@@ -32,7 +32,6 @@ These subagents are available when using Claude Code CLI. Droid can reference th
|
|
|
32
32
|
| docs-builder | Create comprehensive project documentation with structured /docs hierarchy | /docs-builder | false |
|
|
33
33
|
| root-cause-tracing | Systematically traces bugs backward through call stack to identify source | /root-cause-tracing <issue-description> | false |
|
|
34
34
|
| skill-creator | Guide for creating effective skills and extending Claude capabilities | /skill-creator <skill-type> <skill-description> | false |
|
|
35
|
-
| subagent-spawning | Provides TDD-aware templates for spawning fresh subagents | Used by 3-process-task-list and other agents | true |
|
|
36
35
|
| systematic-debugging | Four-phase debugging framework - investigate root cause before any fixes | /systematic-debugging <bug-or-error-description> | false |
|
|
37
36
|
| test-driven-development | Write test first, watch it fail, write minimal code to pass | /test-driven-development <feature-or-behavior-to-test> | true |
|
|
38
37
|
| testing-anti-patterns | Prevents testing mock behavior and production pollution with test-only methods | /testing-anti-patterns <testing-scenario> | true |
|