Files
claude-foundations/memory/reference-infrastructure-docs.md
Paul O'Reilly c3557a3d97 Add formatters, hooks, memory entries and context-load improvements
- 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>
2026-03-19 10:54:49 +13:00

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 .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