From d1f6e915967f97ac753cbc060acc2c53fcf20dec Mon Sep 17 00:00:00 2001 From: Athmika Hebbar Date: Fri, 3 Apr 2026 15:35:00 +0100 Subject: [PATCH] docs: add AI agent instruction files Add AGENTS.md and CLAUDE.md to meet Production Standards for AI readiness. AGENTS.md provides agent-agnostic instructions, CLAUDE.md references it for Claude Code. Ref: MLL-1822 Co-Authored-By: Claude Opus 4.6 (1M context) --- AGENTS.md | 10 ++++++++++ CLAUDE.md | 1 + 2 files changed, 11 insertions(+) create mode 100644 AGENTS.md create mode 100644 CLAUDE.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000000..73431fc1b07 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,10 @@ +## Pull request descriptions + +When creating a pull request: +- Always use the PR template from `.github/pull_request_template.md`. +- Include relevant context from the `docs/plans/` plan file (not `*-implementation.md`) in the PR description body. This preserves the reasoning and design decisions in git history via merge commit descriptions. +- Do NOT include the plan file itself in the commit — plan files are gitignored as temporary artifacts. + +## Superpowers label + +When creating PRs, if the 'superpowers' skills were used, add a PR label `ai: sdd-superpowers` (creating the label if it doesn't exist). diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 00000000000..98346ae3216 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +See [AGENTS.md](./AGENTS.md) for agent instructions.