diff --git a/docs/constitution.md b/docs/constitution.md index 7e8bdc2..6ebec3d 100644 --- a/docs/constitution.md +++ b/docs/constitution.md @@ -63,5 +63,13 @@ config.services = { - Constitution: `docs/constitution.md` (this file) - Reference map: `docs/reference/index.md` (paths, hosts, secrets, proxies, stylix) - MCP server reference: `docs/reference/mcp-server.md` (tools, invocation, sync checks) -- Playbooks: `docs/playbooks/*.md` (add module/server/script/host toggle/secret, plus template) +- Playbook: `docs/playbooks/add-module.md` — add a module in the right category and confirm auto-import. +- Playbook: `docs/playbooks/add-server.md` — add a reverse-proxied server via `mkserver` and proxy rules. +- Playbook: `docs/playbooks/add-script.md` — add a script unit via `mkscript` with install/service/timer options. +- Playbook: `docs/playbooks/add-host-toggle.md` — add or update host toggle maps under `hosts//toggles.nix`. +- Playbook: `docs/playbooks/add-secret.md` — add a SOPS secret in the correct file and wire it into modules. +- Playbook: `docs/playbooks/add-wireguard-peer.md` — add a WireGuard peer and update secrets/hosts. +- Playbook: `docs/playbooks/enroll-vps.md` — enroll a VPS key, re-encrypt secrets, redeploy. +- Playbook: `docs/playbooks/vps-rebuild.md` — rebuild the VPS with the expected deploy flow. +- Playbook template: `docs/playbooks/template.md` - Planning artifacts: `specs/001-ai-docs/` (plan, research, data-model, quickstart, contracts) diff --git a/docs/reference/index.md b/docs/reference/index.md index f38f407..65443b9 100644 --- a/docs/reference/index.md +++ b/docs/reference/index.md @@ -57,7 +57,14 @@ ## Playbooks and Templates - Playbook template: `docs/playbooks/template.md` -- Workflows: `docs/playbooks/add-module.md`, `add-server.md`, `add-script.md`, `add-host-toggle.md`, `add-secret.md` +- Playbook: `docs/playbooks/add-module.md` — add a module in the right category and confirm auto-import. +- Playbook: `docs/playbooks/add-server.md` — add a reverse-proxied server via `mkserver` and proxy rules. +- Playbook: `docs/playbooks/add-script.md` — add a script unit via `mkscript` with install/service/timer options. +- Playbook: `docs/playbooks/add-host-toggle.md` — add or update host toggle maps under `hosts//toggles.nix`. +- Playbook: `docs/playbooks/add-secret.md` — add a SOPS secret in the correct file and wire it into modules. +- Playbook: `docs/playbooks/add-wireguard-peer.md` — add a WireGuard peer and update secrets/hosts. +- Playbook: `docs/playbooks/enroll-vps.md` — enroll a VPS key, re-encrypt secrets, redeploy. +- Playbook: `docs/playbooks/vps-rebuild.md` — rebuild the VPS with the expected deploy flow. - Constitution link-back: `docs/constitution.md` sections on terminology, proxies, secrets, and maintenance. - MCP server reference: `docs/reference/mcp-server.md` (tool catalog, `nixos-mcp` wrapper, invocation, sync-docs)