# Workspace Maintenance

> Maintain workspace documentation hygiene and discoverability. Use when organizing markdown sprawl, updating doc indexes, archiving stale progress/status snapshots, generating dry-run cleanup candidate lists, and keeping memory/task control files aligned without deleting files automatically.

- Skill: `modbender/workspace-maintenance` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add modbender/workspace-maintenance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/workspace-maintenance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/workspace-maintenance

---


# Workspace Maintenance

Run a non-destructive maintenance cycle that keeps docs findable and the root clean.

## Execute Maintenance Cycle

1. Run dry-run retention audit script:
   - `scripts/archive-retention-audit.sh`
2. Regenerate or refresh docs index if categories changed.
3. Ensure active control files remain in root (do not move them).
4. Move stale snapshot/status/progress docs to archive buckets.
5. Update active task tracker with maintenance completion timestamp.
6. Produce human review list for deletion candidates (never delete automatically).

## Constraints

- Never delete files automatically.
- Never move identity/control files out of root.
- Keep changes reversible (moves + manifests).
- Always produce a dry-run candidate report.

## Archive Buckets

- `docs/archive/meridian-snapshots/`
- `docs/archive/general-progress/`
- `docs/archive/session-hygiene/`

## Required Outputs

- Updated dry-run candidates file in archive
- Updated active task status entry
- Move manifest for any batch relocation
- Brief completion summary

## Use Bundled Script

- `scripts/archive-retention-audit.sh` generates current dry-run deletion candidates.