Orchestration — Shared State and Templates

Single-Writer Ledger Pattern

The ledger (.claude/state/ledger.md) is maintained exclusively by the lead orchestrator. This prevents concurrent write corruption.

• Lead: Writes to ledger.md. Reads teammate status files and aggregates them.
• Teammates: Write to their own .claude/state/<name>-status.md. NEVER write to ledger.md.
• Hooks: Write to .claude/state/compaction-events.log. NEVER write to ledger.md.

Worktree Path Rules

When working in a worktree:

• All file operations must target files inside .worktrees/<name>/
• The .claude/state/ directory is shared at the project root
• Access shared state via ../../.claude/state/ (two levels up from worktree) or the absolute path
• Your FIRST action after being spawned must be cd .worktrees/<name>/

Structured Return Templates