| name | wdd-plan-work |
| description | Plan a WDD micro-wave by splitting one work packet into 2-5 compact task briefs and state.json. Use after wdd-start-work when a bounded ticket benefits from compact task planning without full epic planning ceremony. |
WDD Plan Work
Split one work packet into compact tasks and choose bundled, hybrid, or parallel
execution based on overhead and independence.
Preconditions
.wdd/work/<work-id>/brief.md exists.
- The work is bounded enough to finish without epic validation.
- Use
templates/task.md and templates/state.json from this skill folder.
- Do not create tickets, wave plans, shared-context resources, epic validation,
or final PR artifacts for micro-waves unless the user asks to upgrade.
Workflow
-
Load context:
- Constitution.
- Work brief.
- Named files, docs, and tests from the brief.
-
Choose task shape:
- Prefer 2-5 tasks.
- Use one task if parallelism would add cost without reducing risk or time.
- Upgrade to an epic when the work needs multiple waves, ticket containers,
broad shared context, or high-risk validation.
-
Recommend execution strategy:
- Default
micro execution mode is bundled.
- Recommend
parallel only when 2-5 tasks touch independent files and real
wall-clock speedup is likely.
- Recommend
hybrid when there are 2-3 clear subgroups.
- Record profile, execution mode, review mode, monitoring mode, confidence,
rationale, confirmation requirement, bundle groups, and override history in
state.json.
-
Create compact task briefs in .wdd/work/<work-id>/tasks/:
- Objective.
- Scope and non-scope.
- Context to read.
- Likely files.
- Dependencies.
- Conflict domains.
- Validation.
- Done criteria.
-
Write state.json:
- Include
"schemaVersion": 1.
- Include
profile: "micro".
- Track task path, status, branch, worktree, gate, risk, review requirement,
verification, PR or patch, and worker reference.
- Include
strategy with executionMode, bundleGroups, and rationale.
- Include adaptive monitoring state and a durable fallback prompt.
-
Update brief.md:
- Set
status: planned.
- Set
task_count.
- Add task inventory to Finish Notes when useful.
Done When
tasks/*.md exists for each planned micro task.
state.json exists and tracks every task.
state.json records micro-wave strategy.
- The next phase is
wdd-run-work, no WDD, or upgrade to an epic.