builder-state

What problem does it solve?

Persist and resume builder sessions by storing state in docs/builder-state.json and coordinating session activity like heartbeats, PRD claims, and story progress, enabling seamless recovery after interruptions.

Core Features & Use Cases

• Persist and load builder state to enable resumability across sessions and restarts.
• Coordinate events like session start, PRD claim, story progress, ad-hoc tasks, and heartbeat to keep state consistent.
• Use case: If a session crashes mid-PRD, resume from the last completed story and rehydrate UI todos from docs/builder-state.json.

Quick Start

Initialize or resume a builder session by loading docs/builder-state.json, then update and persist state at each key event (start, claim PRD, start/complete stories, and heartbeat).