1# Baton File Schema
2 
3The baton file (`next-prompt.md`) is the communication mechanism between loop iterations. It tells the next agent what to build.
4 
5## Format
6 
7```yaml
8---
9page: <filename-without-extension>
10---
11<prompt-content>
12```
13 
14## Fields
15 
16### Frontmatter (YAML)
17 
18| Field | Type | Required | Description |
19|-------|------|----------|-------------|
20| `page` | string | Yes | Output filename (without `.html` extension) |
21 
22### Body (Markdown)
23 
24The body contains the full Stitch prompt, which must include:
25 
261. **One-line description** with vibe/atmosphere keywords
272. **Design System block** (required) — copied from `DESIGN.md` Section 6
283. **Page Structure** — numbered list of sections/components
29 
30## Example
31 
32```markdown
33---
34page: achievements
35---
36A competitive, gamified achievements page with terminal aesthetics.
37 
38**DESIGN SYSTEM (REQUIRED):**
39- Platform: Web, Desktop-first
40- Theme: Dark, minimal, data-focused
41- Background: Deep charcoal/near-black (#0f1419)
42- Primary Accent: Teal/Cyan (#2dd4bf)
43- Text Primary: White (#ffffff)
44- Font: Clean sans-serif (Inter, SF Pro, or system default)
45- Layout: Centered content, max-width container
46 
47**Page Structure:**
481. Header with title "Achievements" and navigation
492. Badge grid showing locked/unlocked states with icons
503. Progress section with milestone bars
514. Footer with links to other pages
52```
53 
54## Validation Rules
55 
56Before completing an iteration, validate your baton:
57 
58- [ ] `page` frontmatter field exists and is a valid filename
59- [ ] Prompt includes the design system block
60- [ ] Prompt describes a page NOT already in `SITE.md` sitemap
61- [ ] Prompt includes specific page structure details
62