Skip to content

docs: add AGENTS.md contributor and maintainer guide - #2056

Merged
bwplotka merged 1 commit into
prometheus:mainfrom
bwplotka:add-agents-md
Aug 20, 2026
Merged

bwplotka merged 1 commit into
prometheus:mainfrom
bwplotka:add-agents-md

Conversation

@bwplotka

@bwplotka bwplotka commented Jul 16, 2026 •

Copy link
Copy Markdown
Member

Add an AGENTS.md guide capturing patterns, conventions, and preferences observed from recent maintainer reviews in client_golang and shared standards across the Prometheus organization.

Topics covered include:

  • Strict backwards compatibility guarantees and exp/ module guidelines.
  • API design and constructor options struct patterns.
  • Code quality, map/slice aliasing documentation, and collector panic safety.
  • Commit formatting, testing guidelines (testutil helpers, table-driven tests), and performance benchmark requirements.
  • Go code style (starting comments with capital letters and ending with full stops).

TAG=agy
CONV=de421cc1-2c8e-4db2-8a82-a86bc6690f34

Add an AGENTS.md guide capturing patterns, conventions, and preferences observed from recent maintainer reviews in client_golang and shared standards across the Prometheus organization.

Topics covered include:
- Strict backwards compatibility guarantees and exp/ module guidelines.
- API design and constructor options struct patterns.
- Code quality, map/slice aliasing documentation, and collector panic safety.
- Commit formatting, testing guidelines (testutil helpers, table-driven tests), and performance benchmark requirements.
- Go code style (starting comments with capital letters and ending with full stops).

Signed-off-by: Bartek Plotka <bwplotka@gmail.com>

TAG=agy
CONV=de421cc1-2c8e-4db2-8a82-a86bc6690f34
@bwplotka
bwplotka requested review from kakkoyun and vesari as code owners July 16, 2026 12:46
@kakkoyun

Copy link
Copy Markdown
Member

I will have a look at it and run some evals. Thanks for the initiative.

@bwplotka

Copy link
Copy Markdown
Member Author

@kakkoyun ping, should we have something there?

@kakkoyun

Copy link
Copy Markdown
Member

I have something but it shouldn't be a blocker. I'm on PTO we can iterate.

@bwplotka
bwplotka merged commit 3df9b67 into prometheus:main Aug 20, 2026
15 checks passed
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.

2 participants