Skip to content

docs: add AGENTS.md with conventions that cannot be read from the code - #9268

Open
Esteban82 wants to merge 1 commit into
masterfrom
add-agents-md
Open

Esteban82 wants to merge 1 commit into
masterfrom
add-agents-md

Conversation

@Esteban82

Copy link
Copy Markdown
Member

List what a coding agent cannot learn by reading the source: how to set up the build, tests and docs, which files must change together, how the test harness behaves, how modern-mode sessions behave when gmt is run by hand from several shells, and the CI facts that decide what is checked on a PR.

Written with Claude Sonnet 5.5 and reviewed with Claude Opus 5.5.

List what a coding agent cannot learn by reading the source: how to set
up the build, tests and docs, which files must change together (module
registration, longopt tables, module pages, the generated purpose
files), how the test harness behaves (PostScript-only comparison,
GMT_KNOWN_FAILURE turning failures into passes, DVC baselines and the
DagsHub token), how modern-mode sessions behave when gmt is run by hand
from several shells, and the CI facts that decide what is checked on a
PR.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Esteban82
Esteban82 requested review from joa-quim and seisman October 16, 2026 13:20
@Esteban82 Esteban82 added the maintenance Boring but important stuff for the core devs label Oct 16, 2026
@joa-quim

Copy link
Copy Markdown
Member

I don't see anything really useful in the instructions that Claude generated for itself.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

maintenance Boring but important stuff for the core devs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants