| name | project-planner |
| description | First Build-phase skill for pi-forge. Use at the start of the Build phase to turn the approved brief into an executable plan. Reads artifacts/brief.json and writes artifacts/plan.md with the approach, module/feature breakdown (WBS), build sequence, and stack rationale. |
Project Planner (Build phase, step 1)
Turn the approved brief into an executable plan. Run before tdd-builder. Drive transitions only through forge_* tools.
Steps
- Read
artifacts/brief.json (clarified requirements + acceptance criteria).
- Write
artifacts/plan.md containing: the chosen approach; a module/feature breakdown (WBS) with a build sequence; which acceptance criteria each module satisfies; and the stack choice with rationale (consistent with the brief's recommendation).
- Register it:
forge_artifact plan artifacts/plan.md.
- Record any significant design decision with
forge_note.
- Return control to the orchestrator (which will run tdd-builder next). Do not advance the phase yourself.
CXAS path (when project.type = cxas)
Plan the app as CX Agent Studio resources: agents (instructions), tools/toolsets, guardrails, and evaluations. Use the cxas lint rule categories (config, callbacks, tools, evals, structure, schema) as quality targets the build must satisfy.
Rules
- The brief owns what/why; the plan owns how. Don't re-litigate requirements — if the brief is ambiguous, note it and proceed with a stated assumption.
- Keep modules small and independently testable.