skills/golem-powers/archive/SKILL.md
Use when planning a sprint transition, archiving completed work, or resetting the PRD for a fresh start. Archives completed PRD stories to docs.local/. Covers archive, cleanup, sprint transition, reset PRD. NOT for: deleting stories mid-sprint (use prd-manager), viewing PRD status (use ralph-status).
npx skillsauth add etanhey/golems archiveInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Archive completed stories to
docs.local/prd-archive/with full history preservation. Optionally reset the working PRD for a fresh start.
Run these directly - standalone, no ralph.zsh dependency:
| Script | Purpose | Usage |
|--------|---------|-------|
| scripts/archive-snapshot.sh | Create archive snapshot | bash ~/.claude/commands/archive/scripts/archive-snapshot.sh |
| scripts/cleanup-completed.sh | Archive + remove completed | bash ~/.claude/commands/archive/scripts/cleanup-completed.sh |
| What you want to do | Workflow | |---------------------|----------| | Archive current PRD state (snapshot) | workflows/archive-snapshot.md | | Remove completed stories (cleanup) | workflows/cleanup-completed.md |
Each archive creates a timestamped directory:
docs.local/prd-archive/20260123-153000/
├── index.json # PRD index at time of archive
├── stories/ # All story files (completed + pending)
│ ├── US-001.json
│ ├── US-002.json
│ └── ...
└── progress.txt # Ralph progress log
When cleanup is triggered (via --clean or confirming prompt):
*.json files where passes=trueprogress.txt replaced with fresh start headerHistory is always preserved - The archive contains full state before cleanup.
docs.local/prd-archive/tools
The human-eval UX contract for Phoenix views: turn-by-turn scrollable replay (not a scorecard), hide-but-copyable IDs, collapsed thinking, identity chips, tool filters, tiny frozen starter datasets, mark-wrong-in-thread, mobile-first. Use when: building or reviewing ANY Phoenix/eval view, annotation UI, session replay, or human-grading surface. Triggers: phoenix view, eval UI, annotation view, session replay, human eval UX, grading interface. NOT for: Phoenix data pipelines/ingest (capture scripts have their own specs).
tools
macOS systems specialist — AppKit NSPanel architecture, launchd services, socket activation, MCP bridge resilience, syspolicyd, and high-frequency SwiftUI dashboards. Use when building menu-bar apps, LaunchAgents, debugging syspolicyd/Gatekeeper/TCC, resilient UDS/MCP bridges, or SwiftUI dashboards at 10Hz+.
development
Bulk LLM-judging protocol for fleet-dispatched verdict runs (KG cluster, eval harness). Use when: dispatching or running judge workers (J1/J2/RT), planning bulk-apply from verdict JSONL, or triaging evidence_degraded outputs. Triggers: judge fleet, bulk judge, R3 verdicts, kg-judge, RT gate, evidence_degraded. NOT for: single-item code review, Phoenix view UX (use phoenix-human-view), or non-judge eval pipelines.
development
Quiet-down protocol for sprint close: when the fleet wraps, delete ALL polling crons and monitors, send ONE final dashboard + ONE message, then go SILENT. Use when: fleet wraps, all workers done, overnight queue exhausted, sprint close, Etan asleep/away with nothing approved left. Triggers: fleet wrap, wrap the fleet, stand down, going quiet, sprint close. NOT for: mid-sprint monitoring (keep your loops), spawning a successor (use /session-handoff first).