diff --git a/AGENTS.md b/AGENTS.md
index 13c3f3b6..ee536b5e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,44 +1,9 @@
 # AGENTS.md
 
-Source of the API3 documentation at https://docs.api3.org, built with VitePress. Content is Markdown under `docs/`, one directory per section, each with its own `sidebar.js`. Sections are registered in `docs/.vitepress/config.js`. [CONTRIBUTING.md](./CONTRIBUTING.md) is the full contributor guide.
+Source of the API3 documentation at https://docs.api3.org.
 
-## Commands
+Read [CONTRIBUTING.md](./CONTRIBUTING.md) first. It is the source of truth for the repository layout, the page and writing conventions, the checks and the pull request flow. The notes below only cover what automated changes tend to get wrong.
 
-```sh
-pnpm install
-pnpm docs:dev
-pnpm format
-pnpm lint
-pnpm docs:build
-```
-
-`pnpm format` formats the whole project with Prettier. Never hand-format. `pnpm docs:build` regenerates `docs/public/llms.txt` and `llms-full.txt` before building.
-
-Link validation, the same check CI runs:
-
-```sh
-pnpm docs:build
-pnpm docs:serve &
-node ./libs/link-validator.js http://localhost:8082 ./docs/.vitepress/dist/
-```
-
-## Content rules
-
-- Every page listed in a sidebar declares `title` and `pageHeader` in its frontmatter and starts its body with `<PageHeader/>`. A missing `<PageHeader/>` fails the build.
-- A new page goes into the section's `sidebar.js`. A new section needs its own directory with a `sidebar.js` and entries in `config.js` under both `sidebar` and `nav`.
-- Images live next to the page that uses them. Anything linked by URL from prose goes in `docs/public`.
-- `docs/public/llms.txt` and `llms-full.txt` are generated and gitignored. Never edit them.
-- Verify numbers, addresses and quoted CLI output against their source, such as the `api3dao/contracts` repository, on-chain state or API3 Market, before changing them.
-
-## Writing rules
-
-- Write API3 in capitals. Lowercase `api3` only in identifiers: package names, paths, URLs and the logo wordmark. Contract names such as `Api3ReaderProxyV1` and deployed product names such as the `Api3 Core` vault keep their own spelling.
-- `dAPI` and `dApp` in prose, `dapi` and `dapp` in code identifiers.
-- Hyphens instead of long dashes. No semicolons in prose.
-- Name the acting entity, such as API3 or the Market frontend, rather than writing "we" in new text.
-- Do not write facts that the next change turns false: exact counts of things that grow, closed-world claims about a set, or lists that need an edit whenever an entry appears. Link to the source instead.
-
-## Pull requests
-
-- Target `main` and reference the issue in the description, for example `Closes #1`.
-- CI runs `pnpm lint`, `pnpm docs:build` and the link validator. Every pull request gets a Firebase preview deployment.
+- Before finishing, run `pnpm format`, then `pnpm lint` and `pnpm docs:build`, then the link validation described in CONTRIBUTING.md. Never hand-format.
+- The API3 spelling rule has exceptions. Contract names such as `Api3ReaderProxyV1` and deployed product names such as the `Api3 Core` vault are correct as they are.
+- Before changing a number, an address or quoted CLI output, verify it against its source, such as the `api3dao/contracts` repository, on-chain state or API3 Market.
diff --git a/CLAUDE.md b/CLAUDE.md
index 43c994c2..af124701 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1 +1,2 @@
 @AGENTS.md
+@CONTRIBUTING.md
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 5ce491f3..2ffe03ae 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -21,7 +21,9 @@ Both `docs:dev` and `docs:build` first run [`scripts/generate-llms-files.js`](./
 - Write API3 in capitals. Lowercase `api3` is only for identifiers such as package names, paths and URLs, and for the logo wordmark. Contract names such as `Api3ReaderProxyV1` and deployed product names such as the `Api3 Core` vault keep their own spelling.
 - Use `dAPI` and `dApp` in prose, `dapi` and `dapp` in code identifiers.
 - Use hyphens rather than long dashes, and avoid semicolons in prose.
-- Keep pages high level and link to the authoritative source, such as a repository, a contract or API3 Market, instead of duplicating detail that goes stale.
+- Name the acting entity, such as API3 or the Market frontend, rather than writing "we".
+- Keep pages high level and link to the authoritative source, such as a repository, a contract or API3 Market, instead of duplicating detail that goes stale. Do not write facts that the next change turns false, such as exact counts of things that grow or lists that need an edit whenever an entry appears.
+- Verify numbers, addresses and quoted CLI output against their source before changing them, for example the `api3dao/contracts` repository, on-chain state or API3 Market.
 
 ## Checks