Skip to content

docs(agents): add AGENTS.md pointing at eng-governance - #35

Merged
CameronBrooks11 merged 1 commit into
mainfrom
chore/agents-md
Oct 17, 2026
Merged

CameronBrooks11 merged 1 commit into
mainfrom
chore/agents-md

Conversation

@CameronBrooks11

Copy link
Copy Markdown
Contributor

Adds the AGENTS.md that decision 12 mandates and that this repo was missing.

Why now

eng-governance's drift-audit gained a check for this file on 2026-09-10, and
nothing had backfilled the fleet. The result was that 46 of 70 active repos
reported as drifted on this single rule
, which buried the one repo in that
list with substantive findings for over a month. Clearing the rule restores the
audit as a signal worth reading.

What is in the file

The ## Policy section is identical in every repo and is copied verbatim from
repo-template — it points at eng-governance for DECISIONS.md,
standards/, process/ and principles/, and states that anything the file
does not say follows those while anything it does say overrides them here.

Everything below that was written for this repo specifically, from reading it:
what it is, the commands that actually matter, the directory map, and the traps
that look reasonable here and are wrong. No TODO placeholders — a section
that could not be filled truthfully was dropped rather than stubbed.

Every command named was checked against this repo's own justfile / Makefile
/ package.json / workflows rather than assumed, and every file path named was
confirmed to exist. Claims were verified against main.

Review note

The value is concentrated in ## What NOT to do. If anything there is wrong or
misleading, that is worth correcting — a confidently wrong trap is worse than
no file, because it will be believed.

Refs FlowMatrix-AI/eng-governance#122

Decision 12 mandates an AGENTS.md per repository. The drift-audit check for
it landed in eng-governance on 2026-09-10 and nothing had backfilled the
fleet, so 46 of 70 active repos were reported as drifted on that one rule.

Refs FlowMatrix-AI/eng-governance#122
@CameronBrooks11
CameronBrooks11 enabled auto-merge (squash) October 17, 2026 15:53
@CameronBrooks11
CameronBrooks11 merged commit 205a987 into main Oct 17, 2026
2 checks passed
@CameronBrooks11
CameronBrooks11 deleted the chore/agents-md branch October 17, 2026 15:54
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