AGENTS.md: add hierarchical documentation for hosts, home, features, services

AGENTS.md

@@ -1,13 +1,23 @@
 # AGENTS.md - NixOS Configuration Repository
 
-This document provides guidelines for AI agents working on this NixOS flake configuration.
-
-## Repository Overview
+**Generated:** 2025-12-29 | **Branch:** master | **Commit:** 460fc92
 
 Multi-host NixOS flake managing servers and workstations with home-manager integration.
-- **Hosts**: m3-aether, m3-ares, m3-atlas, m3-helios, m3-kratos
-- **User**: m3tam3re
-- **Key inputs**: nixpkgs (unstable), home-manager, agenix, disko, nix-colors
+
+## Host Inventory
+
+| Host | Type | Purpose | Key Services |
+|------|------|---------|--------------|
+| m3-atlas | VPS | Main server | Traefik, containers (n8n, ghost, baserow, vaultwarden, paperless, gitea) |
+| m3-helios | VPS | DNS/Dashboard | AdGuard Home, Homarr, Traefik |
+| m3-ares | Workstation | Desktop | WireGuard VPN, Tailscale, sound, podman |
+| m3-kratos | Workstation | Desktop | WireGuard VPN, Tailscale, Hyprland, gaming |
+| m3-aether | VM | Cloud-init | Minimal config |
+| m3-daedalus | - | Home-manager only | Desktop environment (no NixOS config) |
+
+## Key Inputs
+
+nixpkgs (unstable), nixpkgs-stable (25.05), home-manager, agenix, disko, nix-colors, m3ta-nixpkgs (private fork)
 
 ## Build/Rebuild Commands
 
@@ -245,3 +255,29 @@ Short, descriptive messages:
 - `+package` - Adding new package
 - `service-name: description` - Service changes
 - `host: description` - Host-specific changes
+
+## Container IP Registry (m3-atlas)
+
+Network: `10.89.0.0/24`, Gateway: `10.89.0.1` (postgres host)
+
+| Service | IP | Port |
+|---------|-----|------|
+| baserow | 10.89.0.4 | 3001 |
+| ghost | 10.89.0.10 | 3002 |
+| slash | 10.89.0.11 | 3010 |
+| littlelink | 10.89.0.13 | 3004 |
+| n8n | 10.89.0.14 | 5678 |
+| restreamer | 10.89.0.15 | 3006 |
+| kestra | 10.89.0.17 | 3018 |
+| pangolin | 10.89.0.20 | 3020 |
+
+**Next available IP**: 10.89.0.22
+
+## Feature Flags
+
+Home-manager features use `mkEnableOption` pattern:
+- `features.cli.*` - Shell tools (nushell, fzf, nitch, starship, secrets)
+- `features.desktop.*` - GUI apps (crypto, coding, gaming, hyprland, media, office, rofi, fonts, wayland)
+- `extraServices.*` - NixOS services (ollama, podman, flatpak, virtualisation)
+
+Enable in per-host configs: `features.cli.nushell.enable = true;`