doc-reorglisted

One-pass directory + document + file reorganization — git mv renames, tmp archiving, script sorting, debug artifact cleanup, document classification and archiving (MRD/PRD/ARCH/DESIGN/TEST/RESEARCH), env.md/deploy.md sync. Triggers: directory reorganization, file archiving, tmp cleanup, document classification, README, templates, env, deploy, git mv, file reorganization, archive
liyong-labs/repo-medic · ★ 0 · Code & Development · score 75

Install: claude install-skill liyong-labs/repo-medic

# doc-reorg — Directory + Document Reorganization Self-contained skill. One invocation completes directory restructuring and document archiving. ## 🛑 MANDATORY WORKFLOW — check all before declaring done ### Phase 0: Snapshot + Reconnaissance - [ ] **Read** `references/dir-restructure.md` in full (7 phases) - [ ] **Read** `references/doc-reorganize.md` (5 phases + 6 categories) - [ ] **Backup**: `rsync -a ./ "backup-pre-doc-reorg-$(date +%Y%m%d)/"` (Iron Law 3, for rollback) - [ ] **git status clean** — commit existing uncommitted work before making changes - [ ] 🛑 **GATE**: backup succeeds + working tree clean before entering Phase 1 ### Phase 1: Inventory - [ ] **Directory scan**: `tree -L 3 --noreport` + `find . -maxdepth 2 -type d` to list all subdirectories - [ ] **Document inventory**: list `*.md` files, pre-classify into the 6 MRD/PRD/ARCH/DESIGN/TEST/RESEARCH categories - [ ] **tmp/ candidates**: `find . -name "tmp*" -o -name "*.tmp" -o -name "*.bak*" -o -name "*~"` to list deletion candidates - [ ] **debug artifact candidates**: `.log` / `nohup.out` / `*.pid` / `core.*` files - [ ] **Broken-link candidates**: `rg "\.\./\.\./" --type md` to find possibly broken relative path references ### Phase 2: Classify - [ ] **Script sorting**: scattered `.sh` / `.py` go into `scripts/{deploy,maintenance,cron,utils}/` - [ ] **6 document categories**: scattered `.md` moved by type into `docs/{mrd,prd,arch,design,test,research}/` - [ ] **Duplicate directory merge**: `diff