25 lines
1.2 KiB
Markdown
25 lines
1.2 KiB
Markdown
# 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.
|