# NixOS Development Guidelines (AI Agents)

Auto-generated from feature plans. Last updated: 2026-01-30

## Active Technologies
- Python 3.12 + MCP server library (Python, JSON-RPC/stdin transport), click for CLI entrypoint, pytest + coverage for tests, ruff/black for lint/format (001-mcp-server)
- None (in-memory tool definitions; filesystem access for repo interactions) (001-mcp-server)

- 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-mcp-server: Added Python 3.12 + MCP server library (Python, JSON-RPC/stdin transport), click for CLI entrypoint, pytest + coverage for tests, ruff/black for lint/format

- 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 -->