v2.0 — Dual-file model, environment capture, subcommands
V2.0 — Project State Management
Core upgrade from session handoff tool to project memory layer.
New: Dual-File Model
| File | Role |
|---|---|
PROJECT.ftmd |
Long-term memory — decisions, failures, environment (never deleted) |
HANDOFF-YYYY-MM-DD.ftmd |
Session snapshot — what happened this session, what's next |
Decisions and lessons no longer get lost when handoffs are archived.
New: Environment Auto-Capture
OS, Shell, Node, Python, Git, Claude Code version recorded automatically on every /handoff.
New: Git Snapshot Section
HANDOFF.ftmd now includes branch, last commit, and changed files — the new session doesn't need to rescan the repo.
New: Subcommands
| Command | Purpose |
|---|---|
/handoff |
Generate HANDOFF + update PROJECT + cleanup |
/handoff status |
One-line project status |
/handoff timeline |
Decision log and failure memory in chronological order |
/handoff doctor |
Health check: PROJECT, HANDOFF, Git, Env, Tests |
Changed from v1.x
- HANDOFF.ftmd: 8 → 9 sections (added Git Snapshot)
- HANDOFF count cap: 5 → 3 (PROJECT.ftmd now carries the history)
- New session protocol: reads PROJECT.ftmd first, then HANDOFF
- Source-of-truth rank: PROJECT.ftmd inserted above HANDOFF