jramos/homelab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor(repo): reorganize repository structure for improved navigation and maintainability

Browse Source 
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:
Jordan Ramos
2025-12-02 21:39:33 -07:00
parent eec4c4b298
commit 4f69420aaa
90 changed files with 935 additions and 349 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
disaster-recovery/homelab-export-20251202-204939/exports/system/lsblk.txt Normal file
View File

@@ -0,0 +1,41 @@
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
sda 8:0 0 136.7G 0 disk
├─sda1 8:1 0 1007K 0 part
├─sda2 8:2 0 1G 0 part /boot/efi
└─sda3 8:3 0 135.7G 0 part
├─pve-swap 252:0 0 8G 0 lvm [SWAP]
├─pve-root 252:1 0 43.9G 0 lvm /
├─pve-data_tmeta 252:2 0 1G 0 lvm
│ └─pve-data-tpool 252:4 0 65.8G 0 lvm
│ ├─pve-data 252:5 0 65.8G 1 lvm
│ ├─pve-vm--104--cloudinit 252:6 0 4M 0 lvm
│ └─pve-vm--108--disk--0 252:7 0 4M 0 lvm
└─pve-data_tdata 252:3 0 65.8G 0 lvm
└─pve-data-tpool 252:4 0 65.8G 0 lvm
├─pve-data 252:5 0 65.8G 1 lvm
├─pve-vm--104--cloudinit 252:6 0 4M 0 lvm
└─pve-vm--108--disk--0 252:7 0 4M 0 lvm
sdb 8:16 0 4.4T 0 disk
├─sdb1 8:17 0 4.4T 0 part
└─sdb9 8:25 0 8M 0 part
sr0 11:0 1 1024M 0 rom
zd0 230:0 0 32G 0 disk
├─zd0p1 230:1 0 1M 0 part
└─zd0p2 230:2 0 32G 0 part
zd16 230:16 0 100G 0 disk
├─zd16p1 230:17 0 1M 0 part
└─zd16p2 230:18 0 100G 0 part
zd32 230:32 0 4M 0 disk
zd64 230:64 0 50G 0 disk
├─zd64p1 230:65 0 1M 0 part
└─zd64p2 230:66 0 50G 0 part
zd80 230:80 0 100G 0 disk
├─zd80p1 230:81 0 512M 0 part
└─zd80p2 230:82 0 99.5G 0 part
zd96 230:96 0 32G 0 disk
├─zd96p1 230:97 0 1M 0 part
└─zd96p2 230:98 0 32G 0 part
zd112 230:112 0 32G 0 disk
zd128 230:128 0 32G 0 disk
zd144 230:144 0 32G 0 disk
zd160 230:160 0 32G 0 disk