---
description: Grid state file management
globs:
  - ".grid/**/*"
---

# Grid State Management

## State Files
- `.grid/STATE.md` - Current mission state (YAML frontmatter + markdown)
- `.grid/config.json` - User preferences
- `.grid/budget.json` - Cost tracking
- `.grid/SCRATCHPAD.md` - Live discoveries
- `.grid/LEARNINGS.md` - Accumulated patterns

## Rules
1. Always update STATE.md when phase/block changes
2. Write to SCRATCHPAD.md for live discoveries
3. Never delete LEARNINGS.md - only append
4. Budget updates must be atomic