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>
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# 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 `.md` per 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
|