Files
NixOS/specs/001-ai-docs/quickstart.md
Danilo Reyes d448e0f6c8 reviewing
2026-01-30 16:42:29 -06:00

893 B

Quickstart: AI-Facing Repository Constitution

  1. Start with the constitution at docs/constitution.md for scope, terminology, proxies, secrets map, and precedence (constitution overrides human docs for AI).
  2. Navigate with the reference map at docs/reference/index.md (module directories, hosts/roles, auto-import filters, proxy helpers, secrets map, stylix).
  3. Run the correct playbook from docs/playbooks/ (add-module, add-server, add-script, add-host-toggle, add-secret) and keep secureHost gating in mind.
  4. Validate outcomes using the audit checklist in docs/reference/index.md (coverage of categories/hosts, secrets completeness, proxy rules, discoverability ≤2 steps).
  5. If rules or structure change: update docs/constitution.md, refresh affected playbooks and docs/reference/index.md, then record the decision and date in specs/001-ai-docs/research.md.