maintenance

/pwdev-code:maintenance — Project Maintenance

Role

Utility agent for project housekeeping: archiving completed phase artifacts and generating changelogs from commit history.

Input

$ARGUMENTS: subcommand + optional arguments.

• cleanup → archive completed phase artifacts
• changelog → generate CHANGELOG.md (version auto-detected)
• changelog 1.0.0 → generate CHANGELOG.md for a specific version
• empty → show interactive menu

Procedure

STEP 0 — Language

Follow ${CLAUDE_PLUGIN_ROOT}/references/language.md (resolve lang from .planning/config.json; ask only if unset).

STEP 1 — Route Subcommand

Route on $1 ($2 = optional version):

• cleanup → go to STEP 2

• changelog → go to STEP 3 ($2 = optional version)

• empty → present menu:

  PT-BR:

  Manutencao do Projeto
  
  1. cleanup    — Arquivar artefatos de fases concluidas
  2. changelog  — Gerar CHANGELOG.md a partir dos commits
  
  Escolha (1-2):
  

  EN:

  Project Maintenance
  
  1. cleanup    — Archive completed phase artifacts
  2. changelog  — Generate CHANGELOG.md from commits
  
  Choose (1-2):
  

---

STEP 2 — Artifact Cleanup

STEP 2.1 — Inventory

echo "=== PHASES ==="
ls -la .planning/phases/ 2>/dev/null

echo "=== QUICK ==="
ls -la .planning/quick/ 2>/dev/null

echo "=== CONTEXT ==="
ls -la .planning/context/ 2>/dev/null

echo "=== STATE ==="
cat .planning/state.md 2>/dev/null

echo "=== SIZE ==="
du -sh .planning/ 2>/dev/null

STEP 2.2 — Identify Archivable Items

Rules:

• Phase folders with verify/verify.md ✅ APPROVED → can be archived
• Quick tasks with summary.md ✅ → can be archived
• context/ → keep (may be consulted in the future)
• state.md → NEVER archive
• Active phase spec.md → NEVER archive (it is the active contract)
• .planning/memory/ → NEVER archive (memory is durable by definition; curate it with /pwdev-code:memory forget instead)

STEP 2.3 — Ask the Human

## 🧹 Archivable Artifacts

| Artifact | Size | Status | Suggested action |
|----------|------|:------:|------------------|
| phases/{phase-slug}/ | [X]KB | ✅ Phase complete | Archive |
| quick/{slug}/ | [X]KB | ✅ Complete | Archive |
| context/ | [X]KB | 📚 Reference | Keep |

**Action:** Move archivable items to `.planning/archive/[date]/`

Confirm? (y/n)