c3557a3d97
- formatters/js, md, yaml: new/updated formatter scripts - hooks/set-wezterm-profile.sh: new hook for WezTerm profile switching - scripts/context-load: improvements from recent sessions - HOOKS.md, MEMORY.md: updated documentation and index entries - memory/log, memory/reference-infrastructure-docs.md: session logs and reference Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
Infrastructure Docs Repo
Location
- Filesystem:
~/dev/claude/docs/infrastructure/homelab/ - Repo:
gitea.oreillyit.nz/homelab/infrastructure-docs - SSH remote:
git@gitea.oreillyit.nz-homelab:homelab/infrastructure-docs.git
Purpose
Authoritative catalog of all systems in the homelab environment. Unlike MEMORY.md (accumulated learnings) or CLAUDE.md (project conventions), this is a maintained map — updated when systems are added/removed, not accumulated over time.
Answers: "What depends on X?", "What breaks if Y goes down?", "What manages Z?"
Structure
INDEX.md— thin index listing all system files, grouped by category- One
.mdper system (e.g.,cilium.md,traefik.md,authelia.md) - Each file: what it does, network details, depends on, depended on by, managed by
- Parent
docs/infrastructure/supports multiple locations (future:customer-site-x/)
Categories
- Physical/Hosting: proxmox, vps, bootstrap-vm
- Cluster Core: talos, cilium, argocd
- Storage: proxmox-csi, proxmox-ccm
- Networking: wireguard, caddy, traefik, coredns, dnsmasq
- Identity: authelia, headscale
- Platform: gitea, email-relay, homepage, cert-pipeline
- Applications: octopus-deploy, external-services
Source projects
Documents systems from both cluster-bootstrap and cluster-apps. Shared across projects — not inside any single project repo.
When to update
- Adding/removing/replacing a system
- Dependencies change (new service depends on Authelia, etc.)
- Major version upgrades worth noting