NixOS/specs/001-ai-docs/quickstart.md

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.