// Track

Spec-Driven Development: PRD → Ship

From Idea to Shipped, Spec-First

The spec is the contract with the agent — learn to write PRDs that eliminate scope ambiguity, decompose masters into parallelizable phases, feed specs to the /ship pipeline, and compound every delivery into a better next spec via the retro → lessons → semantic memory layer loop.

9 lessons~69 min total

Lessons are shown in recommended order. Complete them in sequence for the best experience — or jump to any lesson.

Lesson 428·8 min read

Why Spec-First Beats Vibe-Coding

The cost of ambiguous scope compounds silently — a spec written before the first line of code is the cheapest insurance you can buy.

Lesson 429·7 min read

From Raw Idea to PRD

Research transforms a vague idea into a set of constraints — and constraints are what make a PRD buildable.

Lesson 430·8 min read

Anatomy of a Good PRD

A PRD without testable acceptance criteria is a wish list — five required sections that convert it into a buildable contract.

Lesson 431·7 min read

Decomposing a Master PRD

A master PRD that cannot be decomposed is a feature dump — splitting into sequenced per-phase PRDs is what makes parallel dispatch safe.

Lesson 432·8 min read

The Spec → Implementation Handoff

The handoff contract is the bridge between a completed PRD and a dispatched agent — feeding it wrong is as bad as writing a bad spec.

Lesson 433·8 min read

Quality Gates in the Pipeline

Done means the running system works — five gates that enforce this before any PR is opened.

Lesson 434·7 min read

Semantic Review & PR Description

Reviewing against the spec catches wrong-but-correct code — and a PR description that maps to acceptance criteria is self-reviewing.

Lesson 435·7 min read

The Compounding Loop

Every shipped feature is a chance to improve the next spec — but only if the retro → lessons.md → Semantic Memory Layer chain runs every time.

Lesson 436·9 min read

The Spec-Driven Playbook

Idea to shipped: the end-to-end spec-driven playbook with the audit lab that makes every step verifiable.