From 0208cbc093eed6c8b60f9b20259fbaaca5f9d7ac Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Wed, 5 Aug 2026 11:55:49 +0100 Subject: [PATCH] docs: drop the forced code-review neighbour from where-it-fits Co-Authored-By: Claude Opus 5 (1M context) --- .changeset/docs-writing-for-agents-pass.md | 2 +- docs/productivity/writing-for-agents.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.changeset/docs-writing-for-agents-pass.md b/.changeset/docs-writing-for-agents-pass.md index 15553fe..d598a7a 100644 --- a/.changeset/docs-writing-for-agents-pass.md +++ b/.changeset/docs-writing-for-agents-pass.md @@ -12,4 +12,4 @@ The rewrite keeps the levers to one compact list and spends the page on the judg - **The scope is stated as a test**, not a list: does an agent read this document and act? Skills, `AGENTS.md`, specs, tickets and runtime prompts all pass it. - **A "Common questions" section** answers the nine highest-volume ones directly, including the rename, the "streamline" failure where an agent trims for length and cuts behaviour, whether to rewrite documents per model, the skill that only works on the one task it was built from, and the leading-word question from non-native English speakers. - **"It's working if"** added, led by the sharpest signal: the document gets shorter as it gets better, and duplication is the most reliable sign it was never tested. -- **`Where it fits`** now names `code-review` as the neighbour — standards on code, standards on the prose an agent executes from. +- **`Where it fits`** says plainly that it has no chain neighbour: it sits underneath the set rather than beside one skill, and the documents the other skills leave behind are the text it governs. diff --git a/docs/productivity/writing-for-agents.md b/docs/productivity/writing-for-agents.md index d67c048..9f41399 100644 --- a/docs/productivity/writing-for-agents.md +++ b/docs/productivity/writing-for-agents.md @@ -69,4 +69,4 @@ No — finding the word that packs the most behaviour into the fewest tokens is ## Where it fits -This is a reach-for-it-anytime standalone reference — the meta-skill you consult while building the rest of the set, and the one you point at any document an agent already reads. Its closest neighbour is [code-review](https://aihero.dev/skills-code-review), which holds code to your standards the way this holds the prose an agent executes from. When you're unsure which skill or flow fits a task, [ask-matt](https://aihero.dev/skills-ask-matt) routes you over the whole set. +This is a reach-for-it-anytime standalone reference. It has no neighbour in the chain because it sits underneath the whole set rather than beside any one skill: every skill here was written against it, and the documents the other skills leave behind — a `CONTEXT.md` and its ADRs, a spec, a ticket — are exactly the text it governs once an agent has to read them. When you're unsure which skill or flow fits a task, [ask-matt](https://aihero.dev/skills-ask-matt) routes you over the whole set.