handofflisted

# Handoff V2 — Project State Management ## Overview Handoff is the **project memory layer** for Claude Code. It answers one question: > "If I open this project in a fresh session, what do I need to know to start working immediately?" It does this with two files: | File | Role | Lifespan | |------|------|----------| | `PROJECT.ftmd` | Project long-term memory — accumulates decisions, failures, environment | **Persistent.** Lives as long as the project. | | `HANDOFF-YYYY-MM-DD.ftmd` | Session snapshot — what happened THIS session, what's next | **Short-lived.** Read once then archived. | Together they form a complete picture: PROJECT.ftmd tells you the project's history and identity; HANDOFF.ftmd tells you exactly where to pick up. ## FTMD Format FTMD stands for **Frictionless Transfer Markdown Document**. Standard Markdown (CommonMark + GFM tables), UTF-8, LF line endings. No YAML frontmatter, no custom syntax — the filename IS the metadata. Every factual claim tagged `[V]` (verified) or `[?]` (recalled from memory). ## PROJECT.ftmd — Long-Term Memory This file lives at project root and is **never deleted**. Each `/handoff` updates it incrementally. ### Sections | # | Section | Update Rule | |---|---------|-------------| | 1 | **Snapshot** | Overwritten each time — current stage, progress estimate, last-updated date | | 2 | **Environment** | Overwritten each time — auto-captured from the system | | 3 | **Decision Log** | **Appended** — each entry dated, newest fir