# Docs

Long-form reference material for the Oikos platform and homelab infrastructure.
Operational state and topology live in the DB (seeded from `seeds/`); these docs
cover architecture, decisions, procedures, and the system model.

| Path | Contents |
| ---- | -------- |
| [adr/](adr/README.md) | Architecture Decision Records (numbered, append-only) |
| [infrastructure/](infrastructure/) | Homelab infrastructure architecture — network, DNS, mesh, ingress, backups, SSH, VPS hardening, auto-deploy, monitoring |
| [mbse/](mbse/README.md) | Model-Based Systems Engineering views of the platform |
| [mascot/](mascot/README.md) | MBSE subsystem model for the desktop mascot (planned) |
| [operations/](operations/README.md) | Operator runbooks (deploy, rollback, recovery) |
| [secrets/](secrets/README.md) | Secret management procedures and rotation runbook |
| [GLOSSARY.md](GLOSSARY.md) | Term definitions across the homelab |

For agent orientation see [AGENTS.md](../AGENTS.md); for the operating model
see [.agents/OIKOS.md](../.agents/OIKOS.md); for development see
[CONTRIBUTING.md](../CONTRIBUTING.md). Design plans live in
[plans/](../plans/), not here.