Pre-Audit (+6)
Pre-Audit
- Working directory is clean (
git status) - Create backup branch:
git checkout -b backup/pre-hidden-audit - Document current state:
ls -la .*/ > hidden-folders-before.txt
Discovery Phase
- List all hidden folders at root level
- Record size of each hidden folder
- Identify symlinks and their targets
- Check git tracking status for each
Analysis Phase
- Identify duplicate configurations
- Find broken symlinks
- Determine authoritative source for each config type
- Check for active usage in scripts/CI
Planning Phase
- Create target folder structure diagram
- List files to migrate with source/destination
- List files/folders to delete
- Identify scripts/references to update
Execution Phase
- Backup folders before migration
- Migrate content to authoritative locations
- Update git tracking (
git rm --cached,git add) - Remove legacy folders
- Update .gitignore
Verification Phase
- Run tests to ensure nothing broke
- Verify symlinks work (if any remain)
- Confirm scripts still function
- Check CI/CD pipelines
- Commit with descriptive message
Documentation Phase
- Update README if folder structure changed
- Document new standard in AGENTS.md or equivalent
- Remove references to legacy folders in docs