Skip to content

docs: consolidate agent instructions into AGENTS.md - #236

Open
dirvine wants to merge 1 commit into
mainfrom
docs/agents-md-consolidation
Open

dirvine wants to merge 1 commit into
mainfrom
docs/agents-md-consolidation

Conversation

@dirvine

@dirvine dirvine commented Sep 26, 2026 •

Copy link
Copy Markdown
Member

Linear issue

Summary

Replace CLAUDE.md with a trimmed AGENTS.md (Claude Code reads AGENTS.md
natively only when no CLAUDE.md exists). Keep CI gate commands, feature
flags, the 20000-60000 test port range, the always-on payment
verification policy, bootstrap_peers.toml discovery, ADR governance and
the PR template / Linear closing-word rules. Drop generic process rules and
the stale --listen run examples (the CLI flag is --port). Point test-code
comments at AGENTS.md.

Claude Code ≥ 2.1.277 reads AGENTS.md natively, but only when no CLAUDE.md exists in the working directory or any ancestor; one AGENTS.md now serves Claude Code, Codex and other harnesses. Part of a Saorsa workspace-wide cleanup (same change in x0x, ant-quic, saorsa-gossip, …).

Risk tier

  • T0 — docs / tooling / CI / pure UX-output. Repo CI only.
  • T1 — client-only, no network-facing behavior change. CI + prod compat smoke.
  • T2 — node/client logic with behavioral surface, no protocol/format/economics change. Dev testnet + ADR.
  • T3 — protocol / storage format / payments / routing. T2 evidence + adversarial testing.

Compatibility

  • Wire: none
  • Storage: none
  • API: none

Semver impact

  • breaking
  • feature
  • fix

(Docs/comments only — no release bump needed.)

Test evidence

Docs and comments only; no code paths changed. Facts in AGENTS.md were checked against the source.

New dependency

none

ADR

n/a

Mitigation / rollback

Revert the commit.

🤖 Generated with Claude Code

Replace CLAUDE.md with a trimmed AGENTS.md (Claude Code reads AGENTS.md
natively only when no CLAUDE.md exists). Keep CI gate commands, feature
flags, the 20000-60000 test port range, the always-on payment
verification policy, bootstrap_peers.toml discovery, ADR governance and
the PR template / Linear closing-word rules. Drop generic process rules and
the stale --listen run examples (the CLI flag is --port). Point test-code
comments at AGENTS.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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