clean-up
Clean Up - Metroscope
Clean up the repository after an implementation is complete. The code and tests are the source of truth. Keep side documentation only when it records durable knowledge that contributors cannot reasonably recover from the code.
1. Establish the scope
Inspect the implementation diff and repository status. Identify every repository-local artifact created for, or consumed by, the completed work. Do not delete artifacts for unrelated or still-active work. If ownership is ambiguous, ask before deleting it.
2. Delete implementation artifacts
Delete all repository-local artifacts for the completed work, including:
- tickets and task lists
- implementation plans and ticket plans
- specs and PRDs
- handoff, progress, and temporary decision documents
Delete empty directories left behind. Do not preserve these files as historical documentation, and do not move their content into another document. The implemented behavior belongs in code and tests, while source control preserves history.