chore: interview before fixes and keep HANDOFF.md tiny

Require a short user interview before implementing bugs/features, and overwrite or clear HANDOFF.md so it never accumulates session history.

Co-authored-by: Cursor <cursoragent@cursor.com>

AGENTS.md

@@ -6,14 +6,27 @@ Keep this file small. Detail lives in linked docs — load those **only when the
 
 Agents **cannot** open a new Cursor chat. To reset context:
 
-1. Write/update `agents-docs/HANDOFF.md` (`Status: active`) — see `.cursor/rules/handoff.mdc`.
+1. **Overwrite** `agents-docs/HANDOFF.md` entirely (`Status: active`) — never append. See `.cursor/rules/handoff.mdc`.
 2. Ask the user to start a **new chat** and attach `@agents-docs/HANDOFF.md`.
 
-**At session start:** if `agents-docs/HANDOFF.md` has `Status: active`, read it first and continue Next steps. Do not redo Completed work.
+**At session start:** if `Status: active`, read it first and continue Next steps. Do not redo Completed work.
+
+**When the task is finished:** clear the handoff — set `Status: none` and empty all sections (same short template). Never leave a growing archive in `HANDOFF.md`.
 
 ## Named Obsidian bugs
 
-When the user says `fix bug "…"`, follow `agents-docs/BUG_TRACKER.md` § Named fix: open **that one** vault note under `Log/Bugs/`, use it as acceptance criteria, fix in default scope, then set `status: Resolved`. Do not scan the whole bug inbox.
+When the user says `fix bug "…"`, follow `agents-docs/BUG_TRACKER.md` § Named fix: open **that one** vault note, **interview before implementing**, then fix in default scope and set `status: Resolved`. Do not scan the whole bug inbox.
+
+## Interview before implement (user in control)
+
+Before changing product code for a bug or feature:
+
+1. Read the ask / named bug note (cheap orientation only — not a monorepo dig).
+2. Post a **short interview**: your understanding, gaps, A/B/C choices with a recommended default, proposed scope, how you’ll prove done.
+3. **Wait** for the user’s choices. Do not guess past ambiguity.
+4. Implement only what they approved.
+
+Skip only if they say “just fix it” / “no interview”, or an active handoff already has approved decisions and they said continue. See `.cursor/rules/interview-before-fix.mdc`.
 
 ## Default work scope (token fence)
 
@@ -93,11 +106,13 @@ IPC/preload/WS contract changes → `agents-docs/features/<slug>.md` when that c
 
 ## Completion checklist
 
+- [ ] Interview completed (or user opted out); implemented only approved choices
 - [ ] Asked behavior proven (not only unit tests green)
 - [ ] Stayed in scope (`toju-app` + targeted `electron` + CI) unless user expanded it
 - [ ] Appropriate targeted tests for logic changes
 - [ ] Lint via `npm run lint:fix` (not hand-fixed style); build only touched packages
 - [ ] Docs only if contracts changed
 - [ ] Lesson + index entry if corrected this session
-- [ ] If the thread is long and work remains: write `HANDOFF.md` and ask user for a new chat
+- [ ] If the thread is long and work remains: overwrite `HANDOFF.md` and ask user for a new chat
+- [ ] If work from an active handoff is finished: clear `HANDOFF.md` to `Status: none` (empty sections)
 - [ ] PR when requesting merge (`Fixes #<n>` / `Relates to #<n>`)