---

name: state-management description: Managing STATE.md for session continuity and progress tracking

State Management

STATE.md Purpose

Single source of truth for:

• Current position
• Progress
• Decisions
• Blockers
• Context

STATE.md Template

Copy# Project State

## Current Position
- **Phase**: [current]
- **Issue**: [GitHub #]
- **Branch**: [branch]
- **Status**: [in_progress|blocked|complete]

## Progress
[████████░░] 80%

## Active Work
| Agent | Task | Status |
|-------|------|--------|

## Decisions Made
| Decision | Rationale | Date |
|----------|-----------|------|

## Blockers
- [ ] [Blocker] - @human

## Context Usage
~35% - Safe to continue

## Next Steps
1. [Next action]

Update Triggers

• Task completed
• Decision made
• Blocker identified
• Session start/end
• Checkpoint

Keep Compact

Target: < 100 lines