nix-agent-init

# Nix Agent Init ## Overview Make a NixOS/Home Manager config repo agent-ready in one pass. Run `nix-agent inspect-flake` once, then generate three artifacts, each derived from the returned facts and the files you actually read: - `AGENT_MAP.md`: task-routing table plus search shortcuts. - `CLAUDE.md` (+ `AGENTS.md`): a one-screen repo brief. - `.mcp.json`: wires `nix-agent` and `mcp-nixos`. Everything you write must trace back to an observed fact. A sparse repo gets a short map; a rich repo gets a longer one. Never pad with generic NixOS advice, aspirational structure, or rules the facts do not support. If a fact is null or "unknown", say so or omit the row. Do not invent. You do not run `nix flake show` yourself: `nix-agent inspect-flake` does. You do read the repo's own files (module dirs, flake.nix) with your native tools to name real files in the tables. ## Step 1: Inspect Run `nix-agent inspect-flake` (via Bash); it prints the fact bundle as JSON. With no argument it auto-resolves the target; if the user named a repo, pass the path: `nix-agent inspect-flake /path/to/repo`. The returned facts drive every decision below: - `flake_dir`: absolute repo path. Pin `.mcp.json` to this. - `hosts`: nixosConfiguration names. `null` means flake show failed. - `home_configurations`: standalone HM outputs. - `hm_integration`: `"integrated"`, `"standalone"`, `"none"`, or `"unknown"`. - `module_dirs`: dirs where module files actually live. - `auto_import`: `"import-tree"`, `...