genius-filelisted

# The Work File One piece of work = two files (default under `.genius/`; a `## Working Genius` section in `CLAUDE.md`/`AGENTS.md` may pin a different directory): the **snapshot** at `<slug>.md` — the work's current truth, bounded to a screen or two — and the **log** at `<slug>.log.md` — everything that happened on the way, append-only, created at its first entry. The shape of both lives in [FILE-FORMAT.md](FILE-FORMAT.md). The concept: **the files, not conversation memory, carry the work — and state and history grow by different laws, so they get different files with different rules.** The snapshot holds what a cold session acts on: the confirmed problem, the decision, the contract at its current version, the slices and where they stand, what is still open. Its size follows scope, never time — that is what keeps it read closely rather than skimmed. The log holds how it all came to be: the interview, the battlefield, superseded contract versions, slice evidence, corrections. Its size follows time, which costs nothing, because it is never read whole — a link is followed into it when someone asks "why". Conflate the two and the file grows with every discovery until nobody reads it closely, which is how a record dies while still being written to. What that takes: - **Read the snapshot before acting; write the moment a decision lands.** It outranks whatever you remember about the work. `stage:` names where the work is; `contract:` names the version that binds. - **The contract