dtoro
bb5c0717a1
Problem: the narrative docs lacked an enforceable style standard, and
agent-facing instruction (OIKOS/CAVEMAN/CONTRIBUTING) was interleaved with
human content at the repo root.
Change:
- Add .agents/shared/{writing-style,llm-wiki}.md — a lint-checkable prose
standard (with an imperative-voice exception for runbooks/recipes) and the
sources/wiki/index/log layer model.
- Move CAVEMAN.md -> .agents/shared/caveman.md,
CONTRIBUTING.md -> .agents/shared/page-templates.md,
OIKOS.md -> .agents/OIKOS.md; leave thin root stubs so old links resolve.
- Add .agents/domains/{knowledge,operations}/schema.md; operations schema
codifies "plans always live in plans/".
- Repoint live references (AGENTS, README, GLOSSARY, OIKOS) and fix OIKOS.md's
internal relative links for its new depth.
Risk: none to the operational substrate — inventory.yaml, hosts/*.yaml,
oikos/, mcp/, secrets/, bin/ untouched (verified via git status).
Verification: relative-link check across .agents/ clean; substrate churn empty.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
Glossary
Terms and abbreviations used throughout the homelab wiki.
| Term | Meaning |
|---|---|
| Authentik | SSO/identity provider. Core runs on the VPS; forward-auth outpost at LXC 106 on hubris |
| Caddy | Reverse proxy (LXC 121). Terminates TLS for every *.hubris.network hostname |
| Caveman | Terse communication standard for agent responses — no filler, keep substance |
| Forward-auth | Caddy snippet that delegates authentication to an Authentik outpost. Protects web UIs like qBit, SABnzbd |
| Gitea | Git server at git.hubris.network. Hosts all tracked config repos |
| Gluetun | WireGuard VPN sidecar on arriman. All *arr traffic routes through it |
| HAOS | Home Assistant Operating System. VM 108 on hubris |
| Hubris | Primary Proxmox VE node (GMKtec NucBox M6 Ultra). PVE hostname, cluster member 1 |
| LXC | Linux Container (Proxmox). VM-like isolation without a full OS kernel |
| LVM-thin | Thin-provisioned logical volume manager. Used for all container/VM storage |
| MCP | Model Context Protocol (MCP server at mcp.hubris.network). Structured tools for agents to query homelab state |
| Mesh | Overlay VPN for off-LAN connectivity. Netbird is current; Tailscale is legacy |
| Netbird | Preferred mesh VPN. VPS hosts the management plane; all homelab nodes are members |
| OIDC | OpenID Connect. Protocol used by Authentik for SSO login flows |
| Oikos | Agent operating model (.agents/OIKOS.md). OODA loop, risk classes, policy, ontology |
| PVE | Proxmox Virtual Environment — the hypervisor on both hubris and strong |
| SOPS | sops — Mozilla SOPS. Encrypts secrets with age keys so they live in the git repo |
| Strong | Secondary Proxmox VE node. Cluster member 2 (hostname strong, nickname ludo/ludo-mini) |
| Traefik | Reverse proxy on IONOS VPS. Serves *.hubris.network to the public internet |
| VAAPI | Video Acceleration API. Intel/AMD GPU-based hardware transcode for Jellyfin |
| VPS | Virtual Private Server at IONOS (82.165.190.79). Runs Authentik core + Netbird management |
| *\arr | Media automation suite: Sonarr (TV), Radarr (movies), Lidarr (music), Prowlarr (indexer), Bazarr (subtitles), Readarr (books — not in use) |
See also
- Infrastructure index — cross-cutting systems each with their own doc page
- OIKOS operating model — agent policy, risk classes, lifecycle