Files
hermenix/AGENTS.md
T
2026-10-09 14:35:12 -04:00

1.2 KiB

Agent Instructions

MANDATORY FIRST ACTION: Read 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.