Workflow
Objective
Coordinate the standard delivery flow:
brief -> spec -> tdd -> code -> review -> draft-pr
This is a skill entry point, not a command wrapper. Keep the orchestration light and route work into the stage skills instead of duplicating their guidance here.
Instructions
- Ask for the feature or change name and which stage range to run (
full, partial likespec -> code, or resume from an existing artifact). - Check which stage artifacts already exist before asking the user to recreate them:
docs/briefs/docs/specs/docs/qa/reports/
- For each selected stage, invoke the matching skill (
brief,spec,tdd,code,review,draft-pr). Each skill self-routes via its ownInvocationpreface:brief,spec,tdd,code, andtestrun inline in the current chat under the appropriate persona, whilereview,draft-pr, andpr-descriptiondefault to delegating to their owning subagent. - After each stage, summarize:
- what was produced
- which paths changed or were created
- open decisions or blockers
- the next recommended skill
- Keep context compact. Prefer referencing existing artifact paths over restating full document contents.
- Do not create workflow state files or command-era JSON checkpoint files in Phase 1.
PR validation (before draft-pr)
- Prefer targeted checks while iterating; do not rerun full verification on every tiny commit by default.
- Before opening or updating a PR: run a full verification pass from the repo root. Include builds when the change touches app/runtime code, config, dependencies, or anything that could affect shipped output.
- Docs-only edits (markdown with no runtime effect): a full build is not required; still run linting when the diff touches linted paths.
- On follow-up pushes to an open PR, rerun checks when the changeset meaningfully affects verified code.
Stage Outputs
brief->docs/briefs/{feature}.mdspec->docs/specs/{feature}.mdtdd-> failing or newly added unit testscode-> implementation and verification resultsreview->docs/qa/reports/{date}-{branch-or-pr}.mddraft-pr-> branch, commit, and draft PR output


