state-md-pattern-for-cross-session-continuity

A STATE.md file at the repo root serves as the living cross-session bridge for long-running projects. Protocol for every session: git pull → read STATE.md (current phase, next action, blockers) → scan recent git log → do work → update STATE.md → commit with structured trailers → git push. A fresh Claude instance with zero prior context can pick up coherently from STATE.md alone.