Files
oikos/docs/index.md
dtoro f127925d5a archive: prune stale dirs, move actual content to docs/
Deleted stale (Python-era artifacts, superseded by DB):
- archive/oikos-cards/ (46 files, predecessor to DB entity graph)
- archive/ledger/ (5-line JSONL fragment, superseded by DB audit log)

Moved to docs/ (actual, current architecture docs):
- docs/infrastructure/ — 12 infrastructure docs (network, DNS, mesh,
  SSH, ingress, media-permissions, backups, homelab-context, auto-deploy,
  VPS-hardening, monitoring, check-lifecycle)
- docs/secrets/ — secrets README and rotation runbook
- docs/GLOSSARY.md — 28-term homelab glossary

Added STALE.md markers to hermes-plans/ and secrets-issuance/.
Added MOVED.md pointers in archive sources.
Updated docs/index.md to include new paths.
2026-08-16 11:26:27 +02:00

1.1 KiB

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

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