What problem does it solve?
Help distributed developers and multiple Claude sessions avoid conflicting edits, unclear ownership, and lost context by maintaining a shared, versioned project state and clear handoff practices.
Core Features & Use Cases
- Shared State Structure: Defines a _project_specs directory layout with team/state.md, contributors.md, handoffs, session files, and todos to centralize who is working on what.
- Todo Claiming & Handoffs: Standardized claim annotations in active todos plus handoff templates to transfer partial work safely.
- Decision Syncing & Conflict Prevention: Guidance for decisions.md entries, pre-push checks, and checklists to reduce merge conflicts and ensure area owners are reviewed.
- Use Case: A developer joins a session, checks team/state.md for active claims, claims a todo, works while periodically pushing state updates, and creates a handoff note if stepping away.
Quick Start
Summarize the current team state from _project_specs/team/state.md, report claimed todos and conflicts, and help me claim TODO-042 for @alice.