PRDs, Specs, and Project Context

Workflow

1. Pick the deliverable.
2. Gather evidence, constraints, and dependencies.
3. Choose the canonical context surface for the target tool or team workflow.
4. Write decisions first.
5. Add acceptance criteria, rollout gates, and source-backed facts. For delivery across more than one session or worker, add a delivery-milestones table.
6. Validate with the relevant checklist before handoff. For source inventories, run python3 scripts/validate_sources.py --scan-only; it excludes archives and symlinks and exits 2 for invalid or empty scan roots and unreadable source files. Inventory success does not verify claims or live URLs.

Quick Reference