Post-ship documentation update. Reads all docs, cross-references diff, updates README/CLAUDE.md/CHANGELOG/PROGRESS.md to match what shipped.
Shared patterns: Read
.claude/skills/arena-shared-preamble.mdfor Boil the Lake philosophy.
Post-ship documentation sync. Ensures all project docs accurately reflect what was just shipped.
Run this after /ship or after any significant merge to main.
# Get the diff of what was just shipped
# Option A: Compare with previous tag
git log --oneline $(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~10")..HEAD
# Option B: Recent commits on main
git log --oneline -20 --no-merges
Categorize changes:
Read these files and note any discrepancies:
README.mdCLAUDE.mdPROGRESS.mdTASKS.mdCHANGELOG.mddocs/DESIGN.md (if exists)docs/ARCHITECTURE.md (if exists)vercel.json (cron jobs list)package.json (version, scripts, deps)# Find resolved TODOs
grep -rn "TODO\|FIXME" app/ lib/ --include="*.ts" --include="*.tsx"
For each TODO:
Check if any changes affect the memory system:
git add CLAUDE.md PROGRESS.md TASKS.md CHANGELOG.md README.md docs/
git commit -m "docs: post-ship documentation sync
Updated docs to reflect recent changes:
- [list of doc updates]
Co-Authored-By: Claude Opus 4.6 <[email protected]>"
# Documentation Release — [Date]
## Documents Updated
- [x] CLAUDE.md: [what changed]
- [x] PROGRESS.md: [what changed]
- [ ] TASKS.md: no changes needed
- [x] CHANGELOG.md: [version]
## TODOs Cleaned
- Removed [N] resolved TODOs
- [N] TODOs remaining
## Discrepancies Found
- [doc] said [X] but code shows [Y] — fixed
## Suggested Follow-ups
- [any documentation gaps that need user input]