flow-plan
Decompose an approved PWDEV Flow specification into dependency-aware waves and atomic executable tasks. Use when design is approved and the user needs exact file scope, test-first actions, verificatio
SKILL.mdplugins/pwdev-flow/skills/flow-plan/SKILL.md
GitHubPlan executable work
Read planning, specification, artifacts, memory, and safety.
Entry gate
Require an approved spec.md. Stop if the design gate is absent, rejected, or stale relative to requirements.
Procedure
- Read the full specification, decisions, repository governance, relevant code and tests, and selected conventions or lessons.
- Map specification clauses to concrete components and file ownership.
- Build the dependency graph and wave map before writing tasks.
- Split work into atomic tasks using the exact contract in planning: at most five implementation files per task and three tasks per wave.
- Include a failing-test step for each behavior change and exact focused and broader verification commands.
- Mark
Parallel-safe: yesonly for disjoint files and side effects. This metadata does not authorize worker creation. - Check every objective, rule, quality criterion, prohibition, and definition-of-done item maps to at least one task or integration checkpoint.
- Present wave order, dependencies, file scope, risks, and verification strategy for approval.
- On approval, mark state
PLANNED; otherwise revise the plans without editing production code.
Output
Return STATUS, phase slug, wave count, task count, plan paths, gate result, and NEXT. Recommend $flow-execute only after explicit plan approval.