handover

name	handover
description	Generate a session handover note at the end of a work session. Saves to sessions/, updates project status, commits and pushes. Auto-invoked after long sessions (50+ turns).
command	/handover
allowed-tools	["Bash","AskUserQuestion","Edit"]
user-invocable	true
auto-invoke	[{"when":"Session has 50+ turns OR user signals end of session","action":"Suggest /handover to preserve session state before context loss"}]

/handover — Session Handover Note

Trigger

User writes /handover at the end of a work session.

Behavior

Step 1 — Verify system state

Run these checks from $DQIII8_ROOT and note the results:

cd /root/dqiii8
git status --short
git log --oneline -5
python3 -m pytest tests/test_smoke.py -q 2>&1 | tail -1
ls tasks/pending_*.md 2>/dev/null || echo "(no pending tasks)"

Step 2 — Ask user for next steps

Use AskUserQuestion to ask the user before saving anything:

"¿Cuáles son los próximos pasos para la siguiente sesión?"

Offer 4 options based on what you observed in Step 1 (infer from context), plus "Auto" as fallback.

If user selects "Auto" or provides no answer: Infer next steps from:

1. ls tasks/pending_*.md — incomplete task files
2. git log --oneline -10 — look for feat:/fix: commits that mention open issues or TODOs
3. cat my-projects/*/.dq-project.json 2>/dev/null — check next_step fields
4. Uncommitted changes in git status --short — unfinished work
5. Fall back to: "Continuar desde el último estado del proyecto activo"

Step 3 — Run the handover script

cd /root/dqiii8
python3 bin/tools/handover.py

The script generates sessions/YYYY-MM-DD_session_N.md, commits, and pushes.

Step 4 — Inject real next steps

Find the generated file:

ls -t /root/dqiii8/sessions/*.md | head -1

Use Edit to replace the ## Next steps section content with the actual steps collected in Step 2. Format each step as a bullet:

## Next steps
- [step 1 exactly as provided/inferred]
- [step 2]
- ...

Do NOT invent steps. Only write what the user confirmed or what was clearly inferred from system state.

Step 5 — Commit the enriched file

cd /root/dqiii8
git add sessions/
git commit -m "docs: add real next steps to handover $(date +%Y-%m-%d)"
git push origin main

Step 6 — Confirm

Output:

[HANDOVER] Saved · sessions/YYYY-MM-DD_session_N.md
Next steps: [N items]

Notes

• NEVER invent next steps that weren't verified in system state or confirmed by user
• If git push fails (network/auth), the .md file is saved locally — does not block
• Never include sensitive information (API keys, passwords) in the handover
• Variable DQIII8_PROJECT controls the active project (default: dqiii8-core)