Jordan Ramos
4f69420aaa
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>
Homelab Infrastructure Export
This directory contains a complete snapshot of your Proxmox-based homelab infrastructure, collected automatically via the homelab collection script.
Collection Information
- Collection Date: 2025-12-02 20:49:54
- Proxmox Node: serviceslab
- Collection Level: full
- Sanitization Applied: IPs=false, Passwords=true, Tokens=true
Directory Structure
Configuration Files
Proxmox Core Configurations
-
- Datacenter-wide settings
-
- Storage pool definitions
-
- User and permission configurations
-
- Cluster-level firewall rules
Virtual Machines
Each VM configuration is named: Firewall rules (if present):
LXC Containers
Each container configuration is named: Firewall rules (if present):
System Exports
System Information
- Proxmox version, hostname, kernel info
- CPU, memory, and disk information
- Network configuration and routing
- Installed packages
Cluster Information
- Cluster status and membership
- Resource allocation
- Recent tasks
Guest Information
- List of all VMs and containers
- Resource usage and status
- JSON exports for programmatic access
Security Notes
This export may contain sensitive information depending on sanitization settings:
- Passwords: true
- API Tokens: true
- IP Addresses: false
Recommendation: Store this export securely. Do not commit to public repositories without careful review.
Using This Export
As Documentation
These files serve as a snapshot of your infrastructure at a point in time. Use them for:
- Documentation and disaster recovery
- Change tracking (diff with previous exports)
- Migration planning
Infrastructure as Code
Use the collected configurations to:
- Create Terraform/OpenTofu templates
- Build Ansible playbooks
- Document network architecture
Restoration Reference
In a disaster recovery scenario:
- Reinstall Proxmox VE
- Reference storage configuration from
- Reference network setup from
- Recreate VMs/containers using configs in and
- Restore VM disk images from backups
Next Steps
- Review the SUMMARY.md for collection statistics
- Check collection.log for any warnings or errors
- Manually add documentation to the folder
- Create network diagrams and place in
- Version control this export in a private Git repository
- Set up regular collections to track infrastructure changes
Collection Script
This export was created by the Homelab Infrastructure Collection Script. For questions or issues, consult the script documentation.
Generated by homelab-export-script v1.0.0