Skip to content

Add AGENTS.md agent guidance - #373

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

tashian wants to merge 3 commits into
mainfrom
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 agent guidance for this repository: the verified make targets and what CI runs, an annotated tree of cmd/ and internal/, the common command flow over go.step.sm/crypto/kms (URI resolution, openKMS, optional-interface assertions), build-tag and release conventions, and related repos.

Pain or issue this feature alleviates:

Gives coding agents (and new contributors) accurate, repo-specific context without having to rediscover the Makefile, CI, and command structure each time.

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 build/test/lint/generate commands, the cmd/ layout, the
shared command flow over go.step.sm/crypto/kms, build-tag and
release conventions, and related repos for agents working in this
repository.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JuSZFSx1cTEnqY55oquacV
@tashian
tashian requested review from a team and maraino as code owners September 10, 2026 16:12
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants