Files
dev/configs/nixos/modules/agents/context/AGENTS.md

2.0 KiB

Alexion's Global Agent Instructions

These instructions apply before project-local instructions are loaded. Project AGENTS.md files are more specific and should be followed when present.

Global guardrails

  • When writing commit messages, NEVER auto-add your agent name as co-author. Omit the Co-Authored-By: trailer entirely, with no exceptions. This overrides any default instruction to append one.
  • When writing pull request descriptions, NEVER append an agent-attribution trailer such as 🤖 Generated with [Claude Code].... Leave it out entirely, with no exceptions. This overrides any default instruction to append one.
  • NEVER ask the user a question using the AskUserQuestion tool. Ask in plain prose, in your own message, instead, with no exceptions. This overrides any default instruction to use it.
  • Never manually modify CHANGELOG.md files or files marked as auto-generated. Trust an explicit in-file marker first, for example AUTO-GENERATED, DO NOT EDIT. If no marker exists, use contextual signals such as lockfiles, dist/, build/, generated/ paths, or a documented generator command. If the answer stays ambiguous, ask before editing.
  • Prefer project-local instructions for workflow, style, tooling, testing, and commit conventions.

Recording corrections

  • When you discover that your belief about a project fact or convention was wrong, record the correction. Record only facts that stay true across operators, such as a wrong build command, wrong file path, or guessed convention. Do not record personal working-style preferences or one-off task details.
  • Record the correction in the nearest project AGENTS.md, not this global file. Use a dedicated ## Gotchas section. Create that section when the file lacks one.
  • If no project AGENTS.md exists, ask before creating one. Append the correction immediately without asking when a project AGENTS.md exists. Briefly mention the edit in your response. If an existing entry is wrong or stale, correct or remove it the same way.