Keep the next step usable
A new session should not have to rediscover the bug or guess which modules it may edit. Record the working state rather than the whole transcript.
Goal:
Acceptance check:
Constraints and permitted actions:
Done, with artefact and verification:
Open questions:
Next action and expected evidence:
Sources to reread:
Example
For a catalogue search that misses a known item, record that the index only reads descriptions. Keep the sort and filters. The next action is to index titles and check the failing query and an unchanged sorting case. Until those checks pass, the fix is still open.
Check the handoff
Give the note to a new session without the prior transcript. Ask for the goal, one mandatory constraint, what is already verified and what to do next. A file edit is distinct from a verified change in behaviour. Refresh the note when the goal, decision, verification or blocker changes. Use synthetic names and omit messages, credentials and private logs in public examples.
Sources and origin
- Skufosaur Master Codex v5.3
Editorial handoff template. The search example is synthetic.