The Workflow at a Glance

Stadium 8 works in three stages. Planning and building overlap so you are never sitting idle while code is being written.

Stage 1: Intake

What happens	Who
Claude reads your documentation/ folder and asks a few short questions	Claude
Claude produces a project brief summarising what it understood	Claude
You review and approve the brief	You approve

The project brief is the foundation for everything that follows. Nothing gets planned until you've agreed it's correct.

Stage 2: Plan

What happens	Who
Claude proposes the epic list: the major features it plans to build	Claude
You approve the epic list	You approve
For each epic, Claude proposes the individual stories	Claude
You approve each epic's stories before work starts	You approve

While Claude is building one epic, you and Claude are planning the next in the foreground. You are never waiting for code to be written.

Stage 3: Build

What happens	Who
For each story: Claude writes failing tests, then writes code to make them pass	Claude
Automated quality checks run	Automated
Claude asks you to open your browser and verify the feature works	You confirm
Story is committed; next story begins	Claude

After all stories in an epic are verified, Claude opens a pull request to main. It merges once all quality gates pass.

---

Nothing gets built without your approval of the plan. Nothing gets merged without your browser sign-off on each epic.