foundry-tutorial

Spec-Driven Development (SDD) is a workflow that prioritizes planning specifications before implementation. It guides you through writing a spec, reviewing it, selecting implementation tasks, coding, running tests, and delivering a PR—ensuring requirements are clear and validated before shipping.

This tutorial teaches SDD through hands-on walkthroughs using Claude Foundry. You'll read concept explanations, work through a sample spec lifecycle from planning to completion, and practice each SDD stage—planning, review, task selection, implementation, testing, and PR preparation.

SDD follows these stages: plan your spec, review it for gaps, select the next implementation task, write code, run tests to validate quality, and generate a PR-ready summary. Each stage uses orchestrated skills to guide you through the process systematically.

Yes. After learning the SDD workflow through this tutorial, you can apply it to your own specs and projects. The tutorial covers the principles and practical patterns you need to plan systematically, implement incrementally, and validate before delivery.

Read the tutorial file included in references/tutorial.md. No prior SDD knowledge is required. You'll work through guided prompts that teach concepts and walk you through a complete workflow example with Claude Foundry.

SDD prioritizes planning and validation upfront rather than coding first. By writing and reviewing specs before implementation, you catch requirements gaps early, reduce rework, ensure tests align with intent, and deliver higher-quality code with audit trails.