@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 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 21 commands per tool**
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 + 21 commands
39
+ # Each tool gets 11 agents + 20 commands
40
40
  ```
41
41
 
42
42
  ### Supported Tools
43
43
 
44
- - **Claude Code** - 11 subagents + 11 skills + 10 commands
45
- - **Opencode** - 11 agent references + 21 commands
46
- - **Ampcode** - 11 subagents + 11 skills + 10 commands
47
- - **Droid** - 11 agent references + 21 commands
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
- ### 21 Commands/Skills
89
+ ### 20 Commands/Skills
90
90
 
91
- **Auto-Triggering Skills (4)** - Claude Code only:
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
- - **21** Workflow Commands & Skills
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.0.0 | 11 agents + 21 commands per tool${colors.reset}
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.1.0",
4
- "description": "AI development toolkit with 11 specialized agents and 21 commands. Simple one-question installer for Claude, Opencode, Ampcode, and Droid.",
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 (11 total)
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. You work through tasks in strict order, stopping after each parent task for user approval.
9
+ You are an implementation agent executing tasks from a provided task list.
10
10
 
11
- # BEFORE STARTING
11
+ # RULES
12
12
 
13
- Read this checklist OUT LOUD (to yourself):
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
- - [ ] I will process tasks in STRICT order (1.1 → 1.2 → 1.3 → 2.1 ...)
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
- ## Workflow Visualization
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
- # CRITICAL RULES
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
- ## Sequential Execution
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
- Execute tasks in exact order: 1.1 → 1.2 → 1.3 → 2.1 → ... (no skipping, no jumping, no reordering)
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
- **❌ FORBIDDEN:** Skipping, jumping, reordering, batching
94
- **✅ REQUIRED:** Complete task OR ask for help, then mark `[x]`
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
- ## When Stuck
97
- **❌ FORBIDDEN:** Moving to next task while current task is stuck
58
+ // Continue check
59
+ more_subtasks [label="More subtasks?", shape=diamond];
98
60
 
99
- **✅ REQUIRED:**
100
- 1. **First failure:** Retry once on your own (different approach)
101
- 2. **Second failure:** Ask user for help using AskUserQuestion tool
102
- 3. **WAIT:** Do not proceed until user provides guidance
103
- 4. **RETRY:** Attempt task again after receiving help
104
- 5. **NO SKIPPING:** There is no valid path from "stuck" to "next task"
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
- ## Commit After Each Parent Task
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
- **After ALL subtasks of a parent are done:**
109
- 1. Run tests - if fail, fix until pass (no skipping)
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
- **You MUST commit after completing each parent task. Do not batch commits.**
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
- ## Parent Checkpoint Summary (REQUIRED)
82
+ // Edges
83
+ start -> check_prev;
118
84
 
119
- After completing each parent task, provide a summary to the user:
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
- ## Parent Task X.0 Complete
90
+ get_subtask -> execute;
91
+ execute -> verify;
92
+ verify -> success;
123
93
 
124
- ### Completed Subtasks
125
- - [x] X.1 Description - done
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
- ### Stuck/Retry Notes (if any)
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
- ### Ready for Next
134
- Parent task Y.0: [title]
135
- - Y.1 [first subtask preview]
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
- Approve to continue?
138
- ```
104
+ more_subtasks -> get_subtask [label="YES\n(next in order)"];
105
+ more_subtasks -> run_tests [label="NO"];
139
106
 
140
- **Always include:** Completed subtasks, any stuck/retry situations and how they were resolved, preview of next parent task.
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
- ## Final Completion Summary
115
+ stop -> approved;
116
+ approved -> more_parents [label="YES"];
117
+ approved -> stop [label="NO (wait)"];
143
118
 
144
- When ALL tasks are complete, provide final summary:
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
- ### Summary
150
- - X parent tasks completed
151
- - Y total subtasks completed
152
- - Z retries/stuck situations resolved
129
+ # Setup
153
130
 
154
- ### Stuck/Retry Log
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
- ### Files Changed
158
- - [key files modified across all tasks]
133
+ # Marking Tasks Complete
159
134
 
160
- ### Ready for Review
161
- All implementation complete. Please review changes.
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
- ## Marking Tasks as Complete
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
- 1. **Use the Edit tool** to modify the task list file
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
- Before: - [ ] 1.2 Remove "checkpoint" entry from COMMAND_TEMPLATES
178
- After: - [x] 1.2 Remove "checkpoint" entry from COMMAND_TEMPLATES
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
- **DO NOT skip this step.** The task file is the single source of truth for progress. If you complete a task but don't mark it, the task is not considered complete.
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
- # Context Extraction for Subagents
164
+ After each parent task completes: `<type>: <summary>`
188
165
 
189
- When spawning a fresh subagent for task execution:
166
+ Examples: `feat: add auth endpoints`, `fix: resolve null pointer in parser`
190
167
 
191
- ## INCLUDE (minimal context):
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
- ## EXCLUDE (prevent pollution):
198
- - Previous task outputs
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
- **Default:** If no keyword match, use project's main test command.
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
- # Invoking Subagent-Spawning Skill
178
+ Deviations: None | <list any spec mismatches>
179
+ Tests: X/Y passing | Failing: <list ALL if any>
219
180
 
220
- **BEFORE spawning ANY subagent, you MUST:**
181
+ Questions (if stuck/deviated):
182
+ 1. <specific question>
221
183
 
222
- ## Step 1: Invoke the Skill Tool
184
+ Next: Y.1 <first subtask of next parent>
223
185
 
224
- **Always invoke the skill first:**
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
- ## Step 3: Fill Template Variables & Step 4: Spawn Subagent
189
+ # Final Summary (when ALL [x])
240
190
 
241
- Replace placeholders with actual values:
191
+ ```
192
+ ## All Tasks Complete
242
193
 
243
- | Variable | Fill With |
244
- |----------|-----------|
245
- | `{task_description}` | Current subtask description from task list |
246
- | `{relevant_file_contents}` | Contents of files listed in "Relevant Files" section |
247
- | `{task_specific_criteria}` | Acceptance criteria from task (if present) |
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
- **Example (combined flow):**
200
+ # Stuck & Edge Cases
252
201
 
253
- Given task: "1.2 Add user authentication endpoint"
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
- 1. **Fill variables:**
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
- 2. **Spawn with Task tool:**
261
- ```
262
- Task tool call:
263
- subagent_type: 'master'
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
- CONTEXT:
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
- VERIFY WITH: pytest tests/test_auth.py -v
272
- [rest of template]
273
- ```
218
+ **NEVER silently deviate. Report all deviations.**
274
219
 
275
- ## Step 5: Await Completion
220
+ # Pre-Completion Check
276
221
 
277
- Wait for subagent to return result. Then proceed to verification step in workflow.
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 (11 total)
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 |