OPEN INDEX / 001UPDATED 2026-07-25

Stop guessing
what belongs in
AGENTS.md

Real instruction files from serious open-source repositories—indexed by stack, scope, and safety pattern. Every entry points to a fixed source commit.

AGENTS.mdREADME.mdpackage.json

01# Working agreement

02

03## Scope

04Read the nearest rules before editing.

05Keep changes inside the requested package.

06

07## Done means verified

08Run the narrow test while iterating.

09Run the full check before handoff.

10

11## Protect existing work

12Never discard user changes.

100VERIFIED
SOURCES
100
fixed sources
8
rule patterns
744.8K
combined repo stars*
0
invented examples

01 / SOURCE INDEX

See how real projects brief their agents.

Browse fixed snapshots, then read the original file in context. Star counts are discovery metadata captured on 2026-07-25, not a quality score.

Showing 12 of 100 verified sources

SOURCE VERIFIED111 lines

radareorg

radare2

Strong location map, formatting rules, memory safety, and command guidance.

TestingScopeSafetyCode style+3
Stack
C
Stars
24.4K
License
See source
Read source at 1dfe427
SOURCE VERIFIED44 lines

Google

benchmark

A compact policy focused on disclosing and reviewing AI-assisted work.

Safety
Stack
C++
Stars
10.3K
License
Apache-2.0
Read source at ff954e9
SOURCE VERIFIED153 lines

GitoxideLabs

gitoxide

Test-first practices, error handling, commit messages, and path rules.

TestingSafetyCode styleVerification+3
Stack
Rust
Stars
11.7K
License
Apache-2.0
Read source at 2fadbc7
SOURCE VERIFIED348 lines

Replicate

cog

A detailed command index with language-specific conventions.

TestingScopeSafetyCode style+4
Stack
Go
Stars
9.4K
License
Apache-2.0
Read source at 4e62b8b
SOURCE VERIFIED86 lines

loro-dev

loro

A short project snapshot with a context index and self-maintained instructions.

TestingScopeSafetyCode style+4
Stack
Rust
Stars
6K
License
MIT
Read source at 6844fc7
SOURCE VERIFIED98 lines

NextDNS

nextdns

Core principles, testing guidance, dependency checks, and a binary budget.

TestingScopeSafetyCode style+3
Stack
Go
Stars
4.1K
License
MIT
Read source at cd213c9
SOURCE VERIFIED31 lines

Chartbrew

chartbrew

An unusually concise monorepo map with client/server workflow instructions.

TestingCode styleVerificationGenerated files+1
Stack
TypeScript
Stars
4K
License
See source
Read source at 944afa1
SOURCE VERIFIED21 lines

Datadog

stratus-red-team

Twenty-one lines that focus entirely on creating and testing attack techniques.

TestingGenerated filesDocumentation
Stack
Go
Stars
2.4K
License
Apache-2.0
Read source at 52db2f8
SOURCE VERIFIED66 lines

DeepFlow

deepflow

Clearly separates source-of-truth files from generated artifacts.

TestingScopeSafetyCode style+4
Stack
Go
Stars
4.2K
License
Apache-2.0
Read source at 61221a2
SOURCE VERIFIED179 lines

GraphFrames

graphframes

Legacy-code guardrails and regression prevention across Spark versions.

TestingScopeSafetyCode style+3
Stack
Scala
Stars
1.2K
License
Apache-2.0
Read source at 926e9d9
SOURCE VERIFIED211 lines

Palo Alto Networks

docusaurus-openapi-docs

Contributor quick start, required checks, and release instructions.

TestingScopeSafetyCode style+4
Stack
TypeScript
Stars
1.1K
License
MIT
Read source at d6b33f9
SOURCE VERIFIED69 lines

obi1kenobi

cargo-semver-checks

A focused set of scripts for testing and linting proposed changes.

TestingScopeSafetyCode style+2
Stack
Rust
Stars
1.7K
License
Apache-2.0
Read source at a3331d0

02 / REPEATED PATTERNS

The useful parts repeat.

Frequency is descriptive, not proof of effectiveness. These counts come only from the verified source index.

02

88/100 sources

Testing

Exact test commands, useful test scope, and expectations for changed behavior.

Explore this pattern
06

71/100 sources

Scope

Directory boundaries, project maps, and rules for nested instruction files.

Explore this pattern

03 / STARTER BUILDER

Start from patterns, not cargo cults.

Generate a small working agreement, then adapt it to the repository in front of you. The builder never claims that one file fits every codebase.

Include safeguards
Before you pasteReplace generic commands with the repository's actual commands. Delete rules you cannot enforce.
AGENTS.md
# AGENTS.md

## Project map
- Read the nearest README and package manifest before editing.
- Keep changes inside the requested feature or package.
- A nested AGENTS.md overrides this file for its directory.

## Commands
- Install: `npm install`
- Test: `npm test`
- Build: `npm run build`

## Working rules
- Preserve the existing TypeScript and component conventions. Run the configured formatter.
- Prefer the smallest change that satisfies the request.
- Explain any assumption that changes behavior or scope.

## Completion gate
- Run the narrowest relevant tests while iterating.
- Before handoff, run `npm test` and `npm run build`.
- A passing command is evidence for that command only; report anything not verified.

## Safety
- Never discard or overwrite user changes.
- Ask before destructive operations, publishing, spending money, or changing production data.

## Generated files
- Do not edit generated output by hand.
- Find and run the owning generator, then review both source and generated diffs.

## Git
- Keep commits scoped to one logical change.
- Do not push, force-push, rebase shared work, or open a pull request unless requested.
The builder and its evidence are open source.View on GitHub

04 / THE INDEX CONTRACT

Source first.
Summary second.
Hype never.

  1. 01
    Fixed evidence

    Every entry links to a commit, not a floating claim.

  2. 02
    License visible

    We index by default and preserve provenance.

  3. 03
    No popularity shortcut

    Stars help discovery; they do not certify instruction quality.

  4. 04
    Corrections welcome

    Source owners can update, clarify, or request removal.