| name | wiki-archive |
| description | Cleanup tool — sweep for work items with terminal status that were not auto-archived by their originating skill, and move them to archive/ |
| category | wiki |
| model | claude-sonnet-4-6 |
Wiki Archive
Recovery sweep. Skills that set terminal statuses (uat-auto, uat-skip, bug-close, etc.) now automatically move files to archive/ at the time of completion. This skill finds any items that were missed — for example, items from before the auto-archive update, or edge cases where the originating skill didn't complete the move. In a healthy wiki, this skill finds nothing to do.
Move terminal work items from a family directory into archive/ to reduce directory clutter. Terminal items only — items with active statuses are never moved. Safe because links use stable IDs, not paths.
Usage
/wiki-archive [family]
family — one of tasks, uat, bugs, requirements, decisions, roadmaps. Omit to show a count summary across all families without moving anything.
Step 1: Determine scope
If a family was specified, process only that family. Otherwise, scan all 6 families and report terminal item counts, then ask the user which families to archive.
For each family to process, read its lifecycle.md to confirm the terminal statuses for that family:
- tasks:
done, trashed
- uat:
passed, skipped, trashed
- bugs:
closed, wontfix, duplicate, cannot-reproduce
- requirements:
retired
- decisions: all decisions in the group are
accepted or superseded
- roadmaps:
done
Do NOT hardcode these — read lifecycle.md to confirm them before moving anything.
Step 2: Identify terminal items
After reading lifecycle.md to determine terminal statuses, find terminal files with a single grep rather than reading every file:
find wiki/work/<family>/ -maxdepth 1 -name "*.md" \
-not -name "lifecycle.md" -not -name "index.md" -not -name ".gitkeep" \
| xargs grep -lE "^status: (done|trashed)" 2>/dev/null
Substitute the actual terminal status values from lifecycle.md into the pattern. For decisions, use per-block status patterns. Files not returned are active — skip them without reading.
If the move list is empty, report "No terminal items found in <family>/" and stop.
Step 3: Confirm with the user
Show the move list:
Ready to archive N items from wiki/work/<family>/:
- TASK-023-some-slug.md (status: done)
- TASK-031-other.md (status: trashed)
This moves them to wiki/work/<family>/archive/. Links using [[TASK-023]] remain valid.
Proceed? (yes / skip)
Wait for confirmation before moving.
Step 4: Move files and update archive/index.md
For each confirmed file:
- Use
Bash with mv to move the file: mv wiki/work/<family>/<file> wiki/work/<family>/archive/<file>
- Read the file's
id, title, status, and updated frontmatter fields.
- Append a row to
wiki/work/<family>/archive/index.md:
| [[ID]] | Title | final-status | YYYY-MM-DD |
where the date is today's date.
Do NOT edit the moved file itself — its frontmatter and content are preserved exactly.
Step 5: Update wiki/log.md
Append one entry:
## [YYYY-MM-DD] archive | <family> — N items archived
Moved N terminal items from wiki/work/<family>/ to wiki/work/<family>/archive/. IDs: TASK-023, TASK-031, …
Step 6: Report
Print a summary of what was moved. If any files were skipped (e.g., active status found unexpectedly), list them explicitly.
CRITICAL rules
- Never move an active item. If a file's status is not in the terminal set for its family, skip it and warn.
- Never edit content of moved files — only the location changes.
- Never delete — archiving is moving, not deleting.
archive/index.md is append-only — only add rows, never remove or edit existing rows.- The
archive/ directory already exists in every family — do not create it.
