| name | wave-planner |
| version | 2.0.0 |
| description | Transform project issues into execution-ready implementation plans with risk prediction, wave-based organization, specialist agents, and TDD workflow |
| author | William Smith |
| triggers | {"keywords":["plan the work","break this down","create waves","implementation plan","plan the implementation","organize into waves","sprint planning","wave structure"],"explicit":["/wave-planner","/plan"]} |
| tools | ["Read","Task"] |
| composes | ["linear","hive-workers-skill","governance"] |
Wave Planner
Transform project issues into execution-ready implementation plans with wave-based organization, specialist agent assignments, token estimates, and TDD workflow.
Execution
When triggered, immediately:
- Read
./agent-prompt.md
- Spawn a single Task with
subagent_type: "general-purpose" passing the agent-prompt content as the prompt
- Include in the prompt: the user's request, current working directory, and any arguments passed
- Wait for the agent to complete
- Present the agent's summary to the user
Do NOT execute the planning workflow in this session. The subagent handles everything including user interaction (AskUserQuestion), artifact generation, and Linear queries.
Execution Context Requirements
This skill spawns a general-purpose subagent that performs file write operations (implementation plans, ADRs, hive configs).
Foreground execution required: Yes. Background execution auto-denies unapproved Write/Edit tools, causing silent failures when creating artifacts.
Required tools: Read, Write, Edit, Bash, Grep, Glob, Task, AskUserQuestion, TodoWrite
Fallback: If Write/Edit tools are denied, the subagent returns the plan content as text output for the coordinator to write to disk.
Reference: Subagent Tool Permissions Research
Changelog
v2.0.0
- Refactor: Thin dispatcher pattern — full logic extracted to agent-prompt.md
- Skill runs in isolated subagent context, reducing post-compaction restoration from ~400 lines to ~50 lines
See agent-prompt.md for prior changelog entries.
