init

AGENTS.md

@@ -0,0 +1,31 @@
+# NixOS Development Guidelines (AI Agents)
+
+Auto-generated from feature plans. Last updated: 2026-01-30
+
+## Active Technologies
+
+- Documentation set (AI-facing constitution and playbooks) in Markdown (001-ai-docs)
+
+## Project Structure
+
+```text
+docs/                    # Constitution and playbooks for AI guidance
+specs/001-ai-docs/       # Planning artifacts (plan, research, tasks, data model, contracts)
+```
+
+## Commands
+
+- Primary work is authoring markdown; no build/test commands required beyond manual validation.
+
+## Code Style & Rules
+
+- Follow repo conventions: no blank lines between code blocks; comments only when non-obvious; factor duplication into shared helpers/functions in examples.
+- Constitution is authoritative for AI guidance; if human docs conflict, update both with the recorded resolution.
+- Keep language business-level and technology-agnostic in AI-facing docs.
+
+## Recent Changes
+
+- 001-ai-docs: Documentation-focused stack; added docs/ for constitution/playbooks and specs/001-ai-docs/ for planning outputs.
+
+<!-- MANUAL ADDITIONS START -->
+<!-- MANUAL ADDITIONS END -->