# Agent Instructions **MANDATORY FIRST ACTION:** Read [`GUIDELINES.md`](GUIDELINES.md) in full before doing anything in this repository. It is the single source of truth for agent behavior here. Key non-negotiable rules from that file: - **Always present a plan first** and wait for user approval before making any changes — no matter how small the task. - **Never run builds or disk-writing steps directly** (`nix build`, `nix flake check`, `hermenix setup`'s disk/image steps, `dd` to any disk image, `nixos-rebuild` on any consuming host). The **only** allowed build path is the test wrappers: `bin/runtest`, `bin/runvmtest`, and their `-debug` variants. - Never run `hermenix vm rollback` or `hermenix ctl reseed` without explicit, freshly-given confirmation — both destroy live guest state. - Never edit `guest/hardware.nix`'s disk labels without the operator having confirmed `lsblk -f` output first. - Never commit live secrets (`.env` values, API keys, tokens) to `guest/hermes/home` — it's a template seed, not where real credentials go. - When migrating existing data from elsewhere, copy — never move or delete — the source, until the operator confirms the migration is verified. - Never commit or push changes unless explicitly asked.