40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
# 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 (002-mcp-server)
|
|
- None (in-memory tool definitions; filesystem access for repo interactions) (002-mcp-server)
|
|
- Nix (flakes; nixpkgs 25.11) + nixpkgs, flake-parts, sops-nix (003-vps-image-migration)
|
|
- N/A (configuration repo) (003-vps-image-migration)
|
|
- Nix (flakes; nixpkgs 25.11) + NixOS modules, sops-nix, nginx, wireguard, openssh, nftables (004-vps-migration)
|
|
- Files (configuration and secrets) (004-vps-migration)
|
|
|
|
- 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
|
|
- 004-vps-migration: Added Nix (flakes; nixpkgs 25.11) + NixOS modules, sops-nix, nginx, wireguard, openssh, iptables
|
|
- 003-vps-image-migration: Added Nix (flakes; nixpkgs 25.11) + nixpkgs, flake-parts, sops-nix
|
|
- 003-vps-image-migration: Added [if applicable, e.g., PostgreSQL, CoreData, files or N/A]
|
|
|
|
|
|
<!-- MANUAL ADDITIONS START -->
|
|
<!-- MANUAL ADDITIONS END -->
|