Skip to content

Add AGENTS.md agent guidance - #457

Open
tashian wants to merge 3 commits into
masterfrom
carl/eff-787-claude-md
Open

tashian wants to merge 3 commits into
masterfrom
carl/eff-787-claude-md

Conversation

@tashian

@tashian tashian commented Sep 10, 2026 •

Copy link
Copy Markdown
Member

Name of feature:

Adds a AGENTS.md with guidance for coding agents working in this repository.

Pain or issue this feature alleviates:

Agents (and new contributors) otherwise have to rediscover the repo layout, which Makefile targets actually exist, how CI runs, how the admission webhook mutates pods, and which environment variables and config fields the controller reads. The file documents only what was verified against the Makefile, workflows, and source; make build and make test were run and pass.

Supporting links/other PRs/issues:

.claude/CLAUDE.md is a one-line @../AGENTS.md import so Claude Code loads the same file.

Tracks EFF-787.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JuSZFSx1cTEnqY55oquacV

Document the repo layout, verified Makefile targets, CI, the admission
webhook request flow, controller configuration and environment variables,
and the code conventions (logrus, pkg/errors, stdlib testing, hand-rolled
Kubernetes client) so coding agents can work in this repo without
rediscovering them.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JuSZFSx1cTEnqY55oquacV
@github-actions github-actions Bot added the needs triage Waiting for discussion / prioritization by team label Sep 10, 2026
AGENTS.md is the vendor-neutral file read by other coding agents. Claude
Code does not read it natively, so CLAUDE.md becomes a one-line
@AGENTS.md import that loads the same content.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JuSZFSx1cTEnqY55oquacV
@tashian tashian changed the title Add CLAUDE.md agent guidance Add AGENTS.md agent guidance Sep 10, 2026
@tashian
tashian enabled auto-merge (squash) September 10, 2026 16:21
Per review: keep the repo root to AGENTS.md and put the Claude Code
import stub under .claude/, importing @../AGENTS.md.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JuSZFSx1cTEnqY55oquacV
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs triage Waiting for discussion / prioritization by team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants