| name | Finish-Convo |
| description | End a research session — runs update-docs to checkpoint all progress, then commits and pushes. Use update-docs for mid-session checkpoints without ending the session. |
*CRITICAL* Add the following steps to your Todo list using TodoWrite:
- Run the update-docs skill first.
Read and follow skills/update-docs/SKILL.md. This creates/updates the convo summary, saves results with provenance links, and updates RESEARCH_LOG.md and STATUS.md.
- If the session produced something ready to implement:
- Ask the user: "This session produced [X] — should I create a plan doc for implementation?"
- If yes: read and follow the
write-a-plan skill, saving to docs/active/<branch-name>/plans/
- The plan MUST reference the originating convo file
- Stage and commit all changed files:
git add docs/active/<branch-name>/ STATUS.md
git commit -m "convo: <convo-name> — <one-line summary>"
- Add specific files, NOT
git add . or git add -A
- If other files were changed during the session (code, data, etc.), include those too
- Push to remote for backup:
git push -u origin <branch-name>
Research branches can live for weeks — don't let unpushed work accumulate.
- Do NOT:
- Create a PR (research branches stay open until user explicitly asks to merge)
- Merge into main (NEVER without explicit request)
- Run the finish-branch pipeline
- Rewrite STATUS.md with authoritative conclusions