edkuksa/skills
1
0
Fork 0
mirror of https://github.com/mattpocock/skills.git synced 2026-07-29 02:52:42 +07:00
Code Issues Packages Projects Releases Wiki Activity

feat(writing-for-agents): add the cache leading word for environment truth

Browse Source 
Single source of truth now reaches past the document into the environment.
package.json scripts, config files, directory layout and --help output are
authoritative already, so a doc restating them is a cache of a lookup that
earns its load only when the lookup is expensive.

Co-authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Matt Pocock
2026-07-28 12:16:51 +01:00
co-authored by Claude Opus 5
parent 6e742d6441
commit d4e8664be2
3 changed files with 7 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.changeset/writing-for-agents-environment-cache.md
+5
View File
@@ -0,0 +1,5 @@
---
"mattpocock-skills": minor
---
Extend **`writing-for-agents`**' pruning section with a new leading word: **cache**. Single source of truth now reaches past the document into the environment — `package.json` scripts, config files, directory layout, `--help` output are themselves authoritative, so a doc that restates them is a cache of a lookup, earning its load only when the lookup is expensive. The positive target: cache what the agent cannot find by looking (unwritten conventions, the reason behind a choice, gotchas no config confesses), and leave one-file, one-command lookups to the environment, where they cannot go stale.