35 lines
2.0 KiB
Markdown
35 lines
2.0 KiB
Markdown
# 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.
|