Phased PRD + Red/Green Delivery
Overview
Use this skill to drive a task from planning to completion with explicit phase gates.
Read references/prd_red_green_template.md before writing a new PRD.
Workflow
- Confirm scope, success target, and constraints.
- Decide whether to create/update a PRD.
- Draft or revise the PRD with phased red/green structure.
- Execute each phase in order: red -> green -> refactor.
- Track completion in the checklist and update status.
PRD Authoring Rules
- Place documents in
prd/. - Use dated file names:
YYYY_MM_DD_<topic>_prd.md. - Include at minimum:
- Status
- Context
- Goals and non-goals
- Phased plan
- Exit criteria per phase
- Acceptance criteria
- Risks and mitigations
- Implementation checklist
- Keep phases independently testable and incremental.
Red/Green Execution Rules
- Write failing tests/checks first for each phase.
- Record the failing signal (error, unsupported op, mismatch, or failing assertion).
- Implement the smallest possible change set to pass.
- Re-run targeted tests, then adjacent regression tests.
- Refactor only after green and keep semantics unchanged.
Evidence And Reporting
- Report which commands ran and which did not run.
- Include key pass/fail outputs for each phase gate.
- Do not mark a phase complete until exit criteria are verified.
- Mark PRD as
Completedonly when all checklist items are done.
Reference
Use references/prd_red_green_template.md as the default skeleton and execution checklist.
Source: skryl/mlx-ruby — distributed by TomeVault.