Compare commits

..
Author SHA1 Message Date
remote-boxandClaude Sonnet 5 594f0f8318 Add changeset for wait-what CONTEXT-MAP.md fix
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-19 09:45:14 +00:00
remote-boxandClaude Sonnet 5 d6cd26f7f2 wait-what: follow CONTEXT-MAP.md to the right CONTEXT.md
The skill only knew to reach for a root CONTEXT.md, so it went silent
on multi-context repos that index their contexts through
CONTEXT-MAP.md instead.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-19 09:43:41 +00:00
Matt Pocock 9c9f36ccd3 Merge pull request #891 from mattpocock/remove-single-writer-section-grill-with-docs
Remove single-writer section from grill-with-docs docs
2026-08-17 08:54:22 +01:00
Remote Box Agent 0505536390 Remove "It assumes one writer" section from grill-with-docs docs
The section's single-writer framing doesn't fit how the skill is actually used across a team; drop it rather than carry a stale caveat.
2026-08-17 07:23:08 +00:00
Matt Pocock 068b6e0c62 Merge pull request #880 from mattpocock/fix/user-invoked-skill-invocation
Stop skills from calling other user-invoked skills
2026-08-15 22:24:19 +01:00
4 changed files with 7 additions and 8 deletions
+5
View File
@@ -0,0 +1,5 @@
---
"mattpocock-skills": patch
---
wait-what: follow `CONTEXT-MAP.md` to the right `CONTEXT.md` when a repo indexes multiple contexts that way instead of keeping a single root `CONTEXT.md`.
-6
View File
@@ -40,12 +40,6 @@ That third row is the one that catches people out. `CONTEXT.md` is a glossary an
The glossary is the point. Domain language is the thing this skill is actually building — the project's own words, agreed once, so you, the agent and your colleagues stop paying to re-derive them. It is worth saying that not everyone agrees this buys you agent performance: the sharpest public pushback is that a term and its plain-English expansion get the same result from the [model](https://www.aihero.dev/ai-coding-dictionary/model), and that the vocabulary really compresses communication between the humans who share it. That reading still leaves the glossary valuable; it just moves the value.
## It assumes one writer
The stateful outputs assume a single person curating them. A two-developer team running four months in one repo reported state drift on roughly 20% of sampled merged PRs, with ADR citations and README claims the highest-drift surfaces — deliberate, human-curated docs drifted worse than agent memory did. Pruning the stale docs did not hold; the same sweep was stale again within days. What worked was deleting shadow state outright and adding a deterministic citation and link linter to CI.
Related: running the skill repeatedly across unrelated changes in one repo tends to accumulate mixed-topic docs, because nothing separates one session's output from another's. Neither of these is fixed in the skill today.
## Common questions
**Should I use this or `/wayfinder`?**
+1 -1
View File
@@ -22,7 +22,7 @@ The skill says re-pitch **that**, not "that last message". What lost you is usua
The body reuses the leading words already in your global `CLAUDE.md` and your project's `CONTEXT.md`. ASD-STE100 Simplified Technical English sets the register. The ubiquitous language supplies the nouns. The skill, `CLAUDE.md` and `CONTEXT.md` reach for the same [tokens](https://www.aihero.dev/ai-coding-dictionary/token), so invoking it is not a new instruction. It is a reminder of one the agent already agreed to.
If you have no `CONTEXT.md`, the skill still works. You lose only the domain-vocabulary half.
If you have no `CONTEXT.md` — and no `CONTEXT-MAP.md` pointing to one for the context at hand — the skill still works. You lose only the domain-vocabulary half.
## It's working if
+1 -1
View File
@@ -4,4 +4,4 @@ description: Stop. That last message did not land — re-pitch it.
disable-model-invocation: true
---
Wait — I don't understand where you've got to here. Re-pitch that: give me a little bit of context, talk in ASD-STE100 Simplified Technical English, and use the ubiquitous language from `CONTEXT.md`.
Wait — I don't understand where you've got to here. Re-pitch that: give me a little bit of context, talk in ASD-STE100 Simplified Technical English, and use the ubiquitous language from `CONTEXT.md` (follow `CONTEXT-MAP.md` to the right one if the repo has more than one).