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,17 @@
|
||||
#.102
|
||||
agent: 1
|
||||
boot: order=scsi0;net0
|
||||
cores: 4
|
||||
cpu: host
|
||||
memory: 8200
|
||||
meta: creation-qemu=9.0.2,ctime=1739318083
|
||||
name: docker-hub
|
||||
net0: virtio=BC:24:11:5B:F5:95,bridge=vmbr0,firewall=1
|
||||
numa: 0
|
||||
onboot: 1
|
||||
ostype: l26
|
||||
scsi0: Vault:vm-100-disk-0,iothread=1,size=100G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=851c9177-a62a-4b55-b495-31680929bed4
|
||||
sockets: 1
|
||||
vmgenid: 4ec3beb0-5855-4855-ac77-4552d8848429
|
||||
@@ -0,0 +1,19 @@
|
||||
#preparation template vvm
|
||||
boot: order=scsi0;ide2;net0
|
||||
cores: 2
|
||||
cpu: host
|
||||
ide0: local-lvm:vm-104-cloudinit,media=cdrom
|
||||
ide2: none,media=cdrom
|
||||
memory: 5000
|
||||
meta: creation-qemu=9.0.2,ctime=1748116781
|
||||
name: ubuntu-dev
|
||||
net0: virtio=BC:24:11:86:18:0B,bridge=vmbr0,firewall=1
|
||||
numa: 0
|
||||
ostype: l26
|
||||
scsi0: Vault:base-104-disk-0,iothread=1,size=32G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=4d84ed03-fc39-40e0-bdee-dc9a31b20e0d
|
||||
sockets: 1
|
||||
tags: template
|
||||
template: 1
|
||||
vmgenid: f26c1136-40de-4497-b286-50e9df75d977
|
||||
@@ -0,0 +1,17 @@
|
||||
boot: order=scsi0;net0;ide2
|
||||
cores: 4
|
||||
cpu: host
|
||||
ide2: iso-share:iso/ubuntu-24.04.2-desktop-amd64.iso,media=cdrom,size=6194550K
|
||||
memory: 16000
|
||||
meta: creation-qemu=9.0.2,ctime=1747705140
|
||||
name: dev
|
||||
net0: virtio=BC:24:11:0B:94:9A,bridge=vmbr0,firewall=1
|
||||
numa: 0
|
||||
ostype: l26
|
||||
scsi0: Vault:vm-105-disk-0,iothread=1,size=32G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=94e9fcd6-460b-4ba5-bbaa-419b5cf30491
|
||||
sockets: 1
|
||||
spice_enhancements: foldersharing=1,videostreaming=all
|
||||
vga: qxl
|
||||
vmgenid: 23985a38-d287-4b9c-97d6-6ac8056090bc
|
||||
@@ -0,0 +1,15 @@
|
||||
boot: order=scsi0;ide2;net0
|
||||
cores: 2
|
||||
cpu: host
|
||||
ide2: iso-share:iso/ubuntu-24.04.2-desktop-amd64.iso,media=cdrom,size=6194550K
|
||||
memory: 4096
|
||||
meta: creation-qemu=9.0.2,ctime=1762020925
|
||||
name: Ansible-Control
|
||||
net0: virtio=BC:24:11:19:EA:A0,bridge=vmbr0,firewall=1,tag=5
|
||||
numa: 0
|
||||
ostype: l26
|
||||
scsi0: Vault:vm-106-disk-0,iothread=1,size=32G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=adbbe001-4198-4a4d-ba99-3052f7483c10
|
||||
sockets: 1
|
||||
vmgenid: 013f169c-4f1f-4f79-af63-fd57d5dc155a
|
||||
@@ -0,0 +1,18 @@
|
||||
boot: order=scsi0;ide2;net0
|
||||
cores: 2
|
||||
cpu: host
|
||||
ide0: Vault:vm-107-cloudinit,media=cdrom
|
||||
ide2: local:iso/ubuntu-24.04.1-desktop-amd64.iso,media=cdrom,size=6057964K
|
||||
memory: 4096
|
||||
meta: creation-qemu=9.0.2,ctime=1749061520
|
||||
name: ubuntu-docker
|
||||
net0: virtio=BC:24:11:DB:15:0C,bridge=vmbr0,firewall=1
|
||||
numa: 0
|
||||
ostype: l26
|
||||
scsi0: Vault:base-107-disk-0,iothread=1,size=50G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=e63b1ff1-07f8-4809-a3d6-ca03cab2698e
|
||||
sockets: 1
|
||||
tags: template
|
||||
template: 1
|
||||
vmgenid: c59cfcf1-fa27-4438-b707-7f3b7bdc4a2d
|
||||
@@ -0,0 +1,17 @@
|
||||
bios: ovmf
|
||||
boot: order=scsi0;net0;ide0
|
||||
cores: 4
|
||||
cpu: host
|
||||
efidisk0: local-lvm:vm-108-disk-0,efitype=4m,pre-enrolled-keys=1,size=4M
|
||||
ide0: iso-share:iso/refplat-20241223-fcs.iso,media=cdrom,size=12426624K
|
||||
memory: 32000
|
||||
meta: creation-qemu=9.0.2,ctime=1751066715
|
||||
name: CML
|
||||
net0: virtio=BC:24:11:70:E6:08,bridge=vmbr0,firewall=1
|
||||
numa: 0
|
||||
ostype: l26
|
||||
scsi0: Vault:vm-108-disk-0,iothread=1,size=100G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=36809984-61ba-452d-8fa3-78cea42b5e57
|
||||
sockets: 1
|
||||
vmgenid: 7c6b3c35-3e83-4c3e-ac89-823f4395b3dc
|
||||
@@ -0,0 +1,15 @@
|
||||
boot: order=scsi0;ide2;net0
|
||||
cores: 1
|
||||
cpu: x86-64-v2-AES
|
||||
ide2: iso-share:iso/alpine-standard-3.21.0-x86_64.iso,media=cdrom,size=240M
|
||||
memory: 2048
|
||||
meta: creation-qemu=9.0.2,ctime=1762035910
|
||||
name: web-server-01
|
||||
net0: virtio=BC:24:11:5A:51:E5,bridge=vmbr0,firewall=1,tag=5
|
||||
numa: 0
|
||||
ostype: l26
|
||||
scsi0: Vault:vm-109-disk-0,iothread=1,size=32G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=483f4dca-bbd5-4a7d-b796-f1b44d2e6caa
|
||||
sockets: 1
|
||||
vmgenid: 593fcc09-1934-4e9e-af9a-235ac850db41
|
||||
@@ -0,0 +1,15 @@
|
||||
boot: order=scsi0;ide2;net0
|
||||
cores: 1
|
||||
cpu: host
|
||||
ide2: iso-share:iso/ubuntu-24.04.3-live-server-amd64.iso,media=cdrom,size=3226020K
|
||||
memory: 4096
|
||||
meta: creation-qemu=9.0.2,ctime=1762040863
|
||||
name: web-server-02
|
||||
net0: virtio=BC:24:11:19:CE:FF,bridge=vmbr0,firewall=1,tag=5
|
||||
numa: 0
|
||||
ostype: l26
|
||||
scsi0: Vault:vm-110-disk-0,iothread=1,size=32G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=3b8489d7-fdf8-4f2a-8650-9c1327de1cdf
|
||||
sockets: 1
|
||||
vmgenid: 646e0531-ddab-48f5-98a4-f4d15bf32cc7
|
||||
@@ -0,0 +1,15 @@
|
||||
boot: order=scsi0;ide2;net0
|
||||
cores: 1
|
||||
cpu: host
|
||||
ide2: iso-share:iso/ubuntu-24.04.3-live-server-amd64.iso,media=cdrom,size=3226020K
|
||||
memory: 4096
|
||||
meta: creation-qemu=9.0.2,ctime=1762041805
|
||||
name: db-server-01
|
||||
net0: virtio=BC:24:11:C0:5F:B4,bridge=vmbr0,firewall=1,tag=5
|
||||
numa: 0
|
||||
ostype: l26
|
||||
scsi0: Vault:vm-111-disk-0,iothread=1,size=32G
|
||||
scsihw: virtio-scsi-single
|
||||
smbios1: uuid=856b9b58-9146-46fd-88c5-eb8d08fc5f7e
|
||||
sockets: 1
|
||||
vmgenid: 6864f7c4-1576-403f-b7e2-1d542bd1e252
|
||||
Reference in New Issue
Block a user