Skip to content

Add agents.txt v1.0 at repo root#1539

Open
barneywohl wants to merge 1 commit into
anthropics:mainfrom
barneywohl:add-agents-txt
Open

Add agents.txt v1.0 at repo root#1539
barneywohl wants to merge 1 commit into
anthropics:mainfrom
barneywohl:add-agents-txt

Conversation

@barneywohl
Copy link
Copy Markdown

Most of the agents I run (and the one filing this PR) reach for anthropic on day one, so adding an agents.txt here felt worth a try. Happy to sign the Anthropic CLA if it isn't auto-detected on this PR — I noticed prior external contributors call it out in their PR bodies, so flagging up front.

This is complementary to CONTRIBUTING.md, not a replacement. agents.txt is a small, machine-readable v1.0 standard (lineage: robots.txtsitemap.xmlllms.txtagents.txt) that tells autonomous agents what they can and can't do in a repo before they open a PR. Spec: https://github.com/barneywohl/agentpress/blob/main/docs/AGENTSTXT_SPEC.md

What this adds

  • A single agents.txt at the repo root
  • Steers agents toward examples/, tests/, and docs — the surfaces your CONTRIBUTING.md already calls out as generator-safe
  • Marks generated paths (src/anthropic/_client.py, _models.py, types/**, resources/**), .stats.yml, and release-please config as requires_human_approval
  • Prohibits publishing, editing the OpenAPI surface directly, racing the Stainless release PR pipeline, and bypassing CODEOWNERS
  • Points test_command and lint_command at the existing ./scripts/test and ./scripts/lint

What this doesn't do

  • No CI changes, no workflow edits, no new dependencies
  • No code changes anywhere else
  • Not a CLA-style or licensing instrument — purely a contribution-policy hint file for agents
  • Doesn't try to encode anything an agent couldn't already infer from CONTRIBUTING.md; it just makes it parseable

Caveat I want to be upfront about

This SDK is Stainless-auto-generated, so the human-touchable surface is genuinely small — mostly examples/, tests/, and src/anthropic/lib/. The file reflects that honestly rather than pretending the whole repo is open for agent edits. If the maintainers would rather agents stay out entirely, that's a one-line change to [allowed_actions] and I'm glad to make it.

Standard is brand new (shipped this week), so there's no expectation of adoption — happy to close this if it isn't a fit, or to revise based on whatever the SDK team would prefer agents do or not do here.

@barneywohl barneywohl requested a review from a team as a code owner May 13, 2026 19:39
barneywohl pushed a commit to barneywohl/agentpress that referenced this pull request May 13, 2026
…ypescript}, claude-code

- modelcontextprotocol/servers#4154
- anthropics/anthropic-sdk-python#1539
- anthropics/anthropic-sdk-typescript#1043
- anthropics/claude-code#58801

All 5 friendly-seed PRs (per LAUNCH/TARGET_REPOS.md tier 1) now filed.
Holding off on the 15 secondary targets per maintainer guidance:
filing more in one day from the same account would look bot-shaped.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant