vamseeachanta Repo Cleanup
When to Use
- Repository has accumulated build artifacts and temp files
- Multiple agent/coordination directories scattered in root
- Log files and coverage reports cluttering the workspace
- Need to consolidate prototype code and test outputs
- Preparing for a clean commit or release
- After major refactoring work
- Closing out multi-repo CI/test repair streams where only provider telemetry, skill/audit evidence, quick review logs, or session-state churn remains
Closeout Hygiene Pattern
After CI/test repair work is merged, run a repo-scoped evidence sweep before declaring completion: inventory every dirty path, classify it as durable evidence / tracked recurring telemetry / disposable session churn, secret-scan candidate durable files, stage narrowly, commit/push durable evidence, remove or restore disposable quick artifacts, and capture branch + ahead/behind + clean-status proof for every target repo.
See references/ci-readiness-closeout-hygiene.md for the detailed multi-repo checklist and pitfalls.
Repository Relocation Pattern
When moving whole git repositories between workspace roots or storage mounts, preflight source/destination state, preserve any preexisting destination by timestamped rename, and verify destination git identity before deleting the source. For large or timeout-prone trees, resume with tracked rsync -a --delete, compare source/destination rev-parse HEAD, then remove the source only after verification.
See references/repo-relocation-preserve-and-verify.md for the exact move/resume checklist and reporting format.
Related Skills
- module-based-refactor - For restructuring after cleanup
coordination/session-start-routine/SKILL.md- Session initialization
References
- Git clean documentation: https://git-scm.com/docs/git-clean
- Git rm documentation: https://git-scm.com/docs/git-rm
- Gitignore patterns: https://git-scm.com/docs/gitignore
Version History
- 2.2.0 (2026-01-20): Added Benchmark Cleanup and Plan File Archival patterns
- Added Benchmark Artifacts section for handling benchmark directories
- Added Plan Files section for archiving completed specifications
- Added benchmark patterns to .gitignore recommendations
- Updated checklist with benchmark and plan archival items
- 2.1.0 (2026-01-20): Added Final Cleanup Checklist and README Update Checklist
- Added Final Cleanup Checklist with verified DELETE/CONSOLIDATE/KEEP tables
- Confirmed .drcode/ as safe to delete (legacy AI config)
- Added .slash-commands/ consolidation to .claude/docs/commands/
- Added .git-commands/ consolidation to scripts/git/
- Added .benchmarks/ as safe to delete if empty
- Added README Update Checklist for structure documentation
- Added example README structure section template
- Added references to remove checklist
- 2.0.0 (2026-01-20): Major update with hidden folder cleanup learnings
- Added Hidden Folder Cleanup section with legacy AI folder patterns
- Added Consolidation Merge Strategies for conflict resolution
- Added File Count Verification for tracking consolidation progress
- Updated Cleanup Checklist with hidden folder review items
- Documented patterns for .agent-os, .ai, .agent-runtime, .common, .specify, .drcode, .slash-commands
- 1.0.0 (2025-01-20): Initial release based on digitalmodel repository cleanup session
Sub-Skills
- Best Practices
Sub-Skills
- Version Metadata
- 1. Build Artifacts (+5)
- Agent Directories (+4)
- Common Hidden Folders (+2)
- Conflict Resolution Patterns (+2)
- Progress Tracking Commands (+1)
- List Untracked Files (+3)
- For Tracked Files (Use git rm) (+2)
- Gitignore Updates
- Pre-Cleanup (+7)
- Folders to DELETE (Confirmed Safe) (+3)
- Structure Section Updates (+1)
- References to Remove