| name | research-archive |
| description | Archive completed research. Moves the research to archive/ and updates its status. |
Research Archive Skill
Archive a completed research plan after findings have been synthesized and consumed.
Process
-
Identify the research to archive:
- If the user specifies a number/name, use that
- Otherwise, scan
.gumbo/research/NNNN-*/ (exclude archive/ and unnumbered legacy directories) for research with status "synthesized" in .research-state.json
- If multiple candidates, ask user to choose
-
Verify completion:
- Check that
synthesis.md exists
- Check that findings files exist for each question
- If synthesis is missing, ask: "Research has no synthesis yet. Archive anyway?"
-
Update research files:
Update research-plan.md status:
## Status: ARCHIVED
**Archived:** YYYY-MM-DD
Update .research-state.json:
{
"status": "archived",
"archived_at": "2026-01-28T10:30:00Z",
"updated_at": "2026-01-28T10:30:00Z",
...existing fields...
}
-
Move to archive:
mv .gumbo/research/NNNN-topic-name .gumbo/research/archive/
-
Confirm to user:
**Archived:** `.gumbo/research/archive/NNNN-topic-name/`
**Status:** ARCHIVED
**Questions:** N answered
**Synthesis:** Yes/No
**Archived:** YYYY-MM-DD
Notes
- Research referenced by implementation plans (via relative paths like
../../.gumbo/research/NNNN-topic/) will have broken links after archiving. The archive path becomes ../../.gumbo/research/archive/NNNN-topic/. Consider this before archiving research that active plans reference.
- Unnumbered legacy research directories (e.g.,
dagre-layout/, edge-routing-deep-dive/) should not be archived through this skill — they predate the numbering convention.