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:
@@ -998,4 +998,55 @@ shred -u file # For scripts with embedded credentials
|
||||
|
||||
---
|
||||
|
||||
## Current Task: Repository Reorganization and Commit
|
||||
|
||||
**Started**: 2025-12-02
|
||||
**Goal**: Review repository reorganization changes and commit to local repo, then push to Gitea
|
||||
**Phase**: In Progress
|
||||
**Status**: Ready for Librarian review
|
||||
|
||||
### Task Breakdown
|
||||
|
||||
- [ ] **Step 1**: Librarian reviews all staged and untracked changes
|
||||
- Status: Pending
|
||||
- Owner: Librarian
|
||||
- Action: Review deletions, modifications, and new directory structure
|
||||
- Expected: Comprehensive review of repository reorganization
|
||||
|
||||
- [ ] **Step 2**: Create commit with conventional commit message
|
||||
- Status: Pending
|
||||
- Owner: Librarian
|
||||
- Action: Stage appropriate changes and create descriptive commit
|
||||
- Expected: Professional commit message describing reorganization
|
||||
|
||||
- [ ] **Step 3**: Push changes to Gitea
|
||||
- Status: Pending
|
||||
- Owner: Librarian
|
||||
- Action: Execute git push to remote repository
|
||||
- Expected: Successful push to http://192.168.2.102:3060/jramos/homelab.git
|
||||
|
||||
### Changes to Review
|
||||
|
||||
**Deleted Files**:
|
||||
- Multiple documentation files (BUGFIX-SUMMARY.md, COLLECTION-GUIDE.md, GIT-*, QUICK-START.md, etc.)
|
||||
- Collection scripts (collect*.sh, git-*.sh)
|
||||
- Old homelab export archive (homelab-export-20251129-141328/)
|
||||
- Template scripts moved to new location
|
||||
|
||||
**Modified Files**:
|
||||
- INDEX.md
|
||||
|
||||
**New Untracked Directories**:
|
||||
- archive-homelab/ (likely contains moved/archived content)
|
||||
- disaster-recovery/ (new organizational category)
|
||||
- mcp/ (MCP server configurations)
|
||||
- scripts/crawlers-exporters/ (reorganized scripts)
|
||||
- scripts/fixers/ (reorganized scripts)
|
||||
- scripts/qol/ (quality of life scripts)
|
||||
- start-here-docs/ (documentation reorganization)
|
||||
- sub-agents/ (agent configurations)
|
||||
- troubleshooting/ (troubleshooting documentation)
|
||||
|
||||
---
|
||||
|
||||
**Repository**: /home/jramos/homelab | **Branch**: main
|
||||
|
||||
Reference in New Issue
Block a user