refactor(repo): reorganize repository structure for improved navigation and maintainability
Implement comprehensive directory reorganization to improve discoverability,
logical grouping, and separation of concerns across documentation, scripts,
and infrastructure snapshots.
Major Changes:
1. Documentation Reorganization:
- Created start-here-docs/ for onboarding documentation
* Moved QUICK-START.md, START-HERE.md, GIT-SETUP-GUIDE.md
* Moved GIT-QUICK-REFERENCE.md, SCRIPT-USAGE.md, SETUP-COMPLETE.md
- Created troubleshooting/ directory
* Moved BUGFIX-SUMMARY.md for centralized issue resolution
- Created mcp/ directory for Model Context Protocol configurations
* Moved OBSIDIAN-MCP-SETUP.md to mcp/obsidian/
2. Scripts Reorganization:
- Created scripts/crawlers-exporters/ for infrastructure collection
* Moved collect*.sh scripts and collection documentation
* Consolidates Proxmox homelab export tooling
- Created scripts/fixers/ for operational repair scripts
* Moved fix_n8n_db_*.sh scripts
* Isolated scripts with embedded credentials (templates tracked)
- Created scripts/qol/ for quality-of-life utilities
* Moved git-aliases.sh and git-first-commit.sh
3. Infrastructure Snapshots:
- Created disaster-recovery/ for active infrastructure state
* Moved latest homelab-export-20251202-204939/ snapshot
* Contains current VM/CT configurations and system state
- Created archive-homelab/ for historical snapshots
* Moved homelab-export-*.tar.gz archives
* Preserves point-in-time backups for reference
4. Agent Definitions:
- Created sub-agents/ directory
* Added backend-builder.md (development agent)
* Added lab-operator.md (infrastructure operations agent)
* Added librarian.md (git/version control agent)
* Added scribe.md (documentation agent)
5. Updated INDEX.md:
- Reflects new directory structure throughout
- Updated all file path references
- Enhanced navigation with new sections
- Added agent roles documentation
- Updated quick reference commands
6. Security Improvements:
- Updated .gitignore to match reorganized file locations
- Corrected path for scripts/fixers/fix_n8n_db_c_locale.sh exclusion
- Maintained template-based credential management pattern
Infrastructure State Update:
- Latest snapshot: 2025-12-02 20:49:54
- Removed: VM 101 (gitlab), CT 112 (Anytype)
- Added: CT 113 (n8n)
- Total: 9 VMs, 3 Containers
Impact:
- Improved repository navigation and discoverability
- Logical separation of documentation, scripts, and snapshots
- Clearer onboarding path for new users
- Enhanced maintainability through organized structure
- Foundation for multi-agent workflow support
Files changed: 90 files (+935/-349)
- 3 modified, 14 new files, 73 renames/moves
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1 @@
|
||||
[{"cpu":0.0186187802692886,"disk":0,"diskread":8754925056,"diskwrite":98623840256,"id":"qemu/100","maxcpu":4,"maxdisk":107374182400,"maxmem":8598323200,"mem":8120344576,"name":"docker-hub","netin":10940472600,"netout":433402096,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":5471875,"vmid":100},{"cpu":0.000396373773600793,"disk":756023296,"diskread":56942592,"diskwrite":0,"id":"lxc/102","maxcpu":1,"maxdisk":2147483648,"maxmem":2147483648,"mem":111960064,"name":"nginx","netin":6466499856,"netout":1025651322,"node":"serviceslab","status":"running","template":0,"type":"lxc","uptime":6223985,"vmid":102},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"lxc/103","maxcpu":2,"maxdisk":4294967296,"maxmem":2147483648,"mem":0,"name":"netbox","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"community-script;network","template":0,"type":"lxc","uptime":0,"vmid":103},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/104","maxcpu":2,"maxdisk":34359738368,"maxmem":5242880000,"mem":0,"name":"ubuntu-dev","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"template","template":1,"type":"qemu","uptime":0,"vmid":104},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/105","maxcpu":4,"maxdisk":34359738368,"maxmem":16777216000,"mem":0,"name":"dev","netin":0,"netout":0,"node":"serviceslab","status":"stopped","template":0,"type":"qemu","uptime":0,"vmid":105},{"cpu":0.0119351155572363,"disk":0,"diskread":20044764516,"diskwrite":44196287488,"id":"qemu/106","maxcpu":2,"maxdisk":34359738368,"maxmem":4294967296,"mem":3740889088,"name":"Ansible-Control","netin":8096426464,"netout":77216446,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2712783,"vmid":106},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/107","maxcpu":2,"maxdisk":53687091200,"maxmem":4294967296,"mem":0,"name":"ubuntu-docker","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"template","template":1,"type":"qemu","uptime":0,"vmid":107},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/108","maxcpu":4,"maxdisk":107374182400,"maxmem":33554432000,"mem":0,"name":"CML","netin":0,"netout":0,"node":"serviceslab","status":"stopped","template":0,"type":"qemu","uptime":0,"vmid":108},{"cpu":0.0267346588482093,"disk":0,"diskread":572292626,"diskwrite":1008925696,"id":"qemu/109","maxcpu":1,"maxdisk":34359738368,"maxmem":2147483648,"mem":209444864,"name":"web-server-01","netin":4917325955,"netout":3941494,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2697866,"vmid":109},{"cpu":0.00286442773373671,"disk":0,"diskread":5130442360,"diskwrite":21638929920,"id":"qemu/110","maxcpu":1,"maxdisk":34359738368,"maxmem":4294967296,"mem":2422759424,"name":"web-server-02","netin":6548218322,"netout":24100161,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2692908,"vmid":110},{"cpu":0.00381923697831561,"disk":0,"diskread":4973196920,"diskwrite":22098824704,"id":"qemu/111","maxcpu":1,"maxdisk":34359738368,"maxmem":4294967296,"mem":2348294144,"name":"db-server-01","netin":6556023366,"netout":20880204,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2691971,"vmid":111},{"cpu":0.000396373773600793,"disk":2294022144,"diskread":0,"diskwrite":114688,"id":"lxc/113","maxcpu":2,"maxdisk":21474836480,"maxmem":4294967296,"mem":498909184,"name":"n8n","netin":1092664063,"netout":20852346,"node":"serviceslab","status":"running","template":0,"type":"lxc","uptime":201537,"vmid":113}]
|
||||
@@ -0,0 +1,4 @@
|
||||
VMID Status Lock Name
|
||||
102 running nginx
|
||||
103 stopped netbox
|
||||
113 running n8n
|
||||
@@ -0,0 +1,10 @@
|
||||
VMID NAME STATUS MEM(MB) BOOTDISK(GB) PID
|
||||
100 docker-hub running 8200 100.00 1370101
|
||||
104 ubuntu-dev stopped 5000 32.00 0
|
||||
105 dev stopped 16000 32.00 0
|
||||
106 Ansible-Control running 4096 32.00 1020188
|
||||
107 ubuntu-docker stopped 4096 50.00 0
|
||||
108 CML stopped 32000 100.00 0
|
||||
109 web-server-01 running 2048 32.00 1124720
|
||||
110 web-server-02 running 4096 32.00 1159023
|
||||
111 db-server-01 running 4096 32.00 1165739
|
||||
Reference in New Issue
Block a user