[m-murphy]

Summary

AGENTS.md becomes a short router. Rules for writing code move to CODING_STANDARDS.md, which the code-review skill reads as its standards source. ADR-derived rules are not in this PR; they are in #92, stacked on this one, so they can be reviewed on their own.

The first three commits each go further than the last, so a reviewer can stop at any one of them. The rest are follow-ups from review.

Commit	What it does
6662a62	Conservative pass. Cuts no-ops from AGENTS.md and docs/agents/: generic gh usage and a triage table that mapped each role to itself. Starts CODING_STANDARDS.md.
3efb494	Moderate pass. Moves test and database rules out of the package READMEs into CODING_STANDARDS.md. Cuts stale counts, duplicated sections and the Vitest stack-overflow note.
bf1cbda	Radical pass. Rewrites AGENTS.md as a router: Agent skills, running tests and checks, where to look. Deletes docs/agents/ and inlines what is still live.
d4a8e9a	Takes the ADR-derived rules back out of CODING_STANDARDS.md; #92 adds them.
dd642a4	Cites ADRs as "ADR 0006" in the files this PR touches.
bfa8d40	Writes the coding standards as second-person imperatives.
bf9746b	Lets read-only tools that must not migrate (check-integrity.ts, the snapshot test) skip openOperationalDatabase.
d2797d8	Says when hand-rolled session helpers (loginAndGetCookie) are acceptable.
08e081c	Puts the reason for withWriteTransaction next to the rule.
85cb068	Restores test rules the README rewrite dropped: error cases, loading and error states, findBy/waitFor.
acb19ec	Keeps the whole-*Api override rule in CODING_STANDARDS.md only.
8e96e89	Describes the pre-commit hook and ci:verify in README.md only.
be5a547	Names the five triage labels in AGENTS.md.
35f4f1d	Renames the AGENTS.md "Checks" heading so it isn't confused with the Checks workflow.
c0f3e55	Says what CODING_STANDARDS.md holds in the AGENTS.md pointer.
063c188	Gives AGENTS.md an H1.
af31451	Makes the root README the one place for coverage targets.
d40df05	Restores the CURRENT_SCHEMA_VERSION bullet in the db README.
f51b352	Says which code may run DDL (evolution modules and test fixtures may; connection code, routes and lib/ may not), and scopes the web test rules (helper render, role/label queries, user-event) to new and changed tests.
c23c9f3	AGENTS.md: API tests run with NODE_ENV=test, contract tests and the root bun run test are listed, setup:hooks is back, and the lint note no longer claims lint is clean today.
2d7ce70	Makes the API README snippet compile (imports) and the web README example assert by role.

Line counts against the base branch:

 AGENTS.md                              52 → 23 lines (router: skills, tests and checks, pointers)
+CODING_STANDARDS.md                    43 lines (domain language, tests, API, web)
-docs/agents/domain.md
-docs/agents/issue-tracker.md
-docs/agents/triage-labels.md
 packages/api/src/__tests__/README.md  236 → 93
 packages/web/src/__tests__/README.md  223 → 76
 packages/api/src/db/README.md          71 → 69

Fixed along the way: the "431 tests" count; a 60% API coverage threshold that bunfig.toml does not set; ci:verify described as "typecheck + build"; an API route-handler example that matched no real route; stale better-sqlite3 and coverage comments in the vitest configs and bunfig.toml. Config values are unchanged.

Evidence

• Before: the web README and vitest.config.ts warned about a RangeError stack overflow after test runs.
  After: a full web bun run test passes 909 tests in 155 files and exits cleanly with no RangeError, so the warning is gone.
• bun run typecheck, the pre-commit hook and the docs stale-claims check pass.
• A grep for docs/agents turns up no references left in the repo.
• Each rule in CODING_STANDARDS.md either holds for the code at head or is scoped to new and changed code with the known exceptions named.

Merge Danger

Door: two-way

Docs and comments only. Reverting any one commit restores the earlier shape.

Blast Radius: agent-behaviour

code-review will enforce CODING_STANDARDS.md. Its rules restate what the package READMEs already said; the ADR-derived rules arrive in #92.

🤖 Generated with Claude Code