refactor(skills): retrofit the corpus to the ADR-0020 context contract #129

Merged
Defame1297 merged 89 commits from refactor/adr0020-skill-retrofit into main 2026-09-01 13:47:47 +00:00
4 changed files with 12 additions and 12 deletions
Showing only changes of commit 264a5dbd67 - Show all commits

View File

@@ -80,13 +80,13 @@ table** plus the gates common to every branch, and each flow lives in its own se
`references/` file. Inlining all of them is a FAIL regardless of word count, because every `references/` file. Inlining all of them is a FAIL regardless of word count, because every
invocation then pays for every branch it did not take. invocation then pays for every branch it did not take.
The reference shape in this repo is `apm-workflow`: a **421-word body** dispatching to roughly The reference shape in this repo is `apm-workflow`: a **237-word body** dispatching to roughly
3,000 words of references across five mutually exclusive invocations. Its whole-file count is 554 3,200 words of references across five mutually exclusive invocations. Its whole-file count is 304
words — cite 421 when calibrating a body, or the conflation this section warns against reappears words — cite 237 when calibrating a body, or the conflation this section warns against reappears
in the finding itself. in the finding itself.
Note its wiring: a three-column table (invocation, action, reference file) closed by one line, Note its wiring: a three-column table (invocation, action, reference file) closed by one line,
*"Read only the reference file matching the requested action."* That is the endorsed shape, and it *"Read only the reference file matching the requested action …"* That is the endorsed shape, and it
is why the literal-conditional requirement above exempts a body that dispatches. Do not flag it. is why the literal-conditional requirement above exempts a body that dispatches. Do not flag it.
## Gotchas sections ## Gotchas sections

View File

@@ -120,8 +120,8 @@ A generic pointer ("see references/ for details") is a Vale error — the agent
**Dispatch is mandatory at two or more mutually exclusive flows.** The body carries the dispatch **Dispatch is mandatory at two or more mutually exclusive flows.** The body carries the dispatch
table and the gates common to every branch; each flow gets its own self-contained `references/` table and the gates common to every branch; each flow gets its own self-contained `references/`
file. Exemplar: the `apm-workflow` skill — a **421-word body** dispatching to 3,006 words of file. Exemplar: the `apm-workflow` skill — a **237-word body** dispatching to 3,222 words of
references. Calibrate against 421: that file's whole-file count is 554 words, and aiming at that references. Calibrate against 237: that file's whole-file count is 304 words, and aiming at that
number instead overshoots the body budget by ~30%. number instead overshoots the body budget by ~30%.
**Length.** 600 words SUGGESTION, 900 words FAIL, counting the **body only** — everything after **Length.** 600 words SUGGESTION, 900 words FAIL, counting the **body only** — everything after

View File

@@ -80,13 +80,13 @@ table** plus the gates common to every branch, and each flow lives in its own se
`references/` file. Inlining all of them is a FAIL regardless of word count, because every `references/` file. Inlining all of them is a FAIL regardless of word count, because every
invocation then pays for every branch it did not take. invocation then pays for every branch it did not take.
The reference shape in this repo is `apm-workflow`: a **421-word body** dispatching to roughly The reference shape in this repo is `apm-workflow`: a **237-word body** dispatching to roughly
3,000 words of references across five mutually exclusive invocations. Its whole-file count is 554 3,200 words of references across five mutually exclusive invocations. Its whole-file count is 304
words — cite 421 when calibrating a body, or the conflation this section warns against reappears words — cite 237 when calibrating a body, or the conflation this section warns against reappears
in the finding itself. in the finding itself.
Note its wiring: a three-column table (invocation, action, reference file) closed by one line, Note its wiring: a three-column table (invocation, action, reference file) closed by one line,
*"Read only the reference file matching the requested action."* That is the endorsed shape, and it *"Read only the reference file matching the requested action …"* That is the endorsed shape, and it
is why the literal-conditional requirement above exempts a body that dispatches. Do not flag it. is why the literal-conditional requirement above exempts a body that dispatches. Do not flag it.
## Gotchas sections ## Gotchas sections

View File

@@ -120,8 +120,8 @@ A generic pointer ("see references/ for details") is a Vale error — the agent
**Dispatch is mandatory at two or more mutually exclusive flows.** The body carries the dispatch **Dispatch is mandatory at two or more mutually exclusive flows.** The body carries the dispatch
table and the gates common to every branch; each flow gets its own self-contained `references/` table and the gates common to every branch; each flow gets its own self-contained `references/`
file. Exemplar: the `apm-workflow` skill — a **421-word body** dispatching to 3,006 words of file. Exemplar: the `apm-workflow` skill — a **237-word body** dispatching to 3,222 words of
references. Calibrate against 421: that file's whole-file count is 554 words, and aiming at that references. Calibrate against 237: that file's whole-file count is 304 words, and aiming at that
number instead overshoots the body budget by ~30%. number instead overshoots the body budget by ~30%.
**Length.** 600 words SUGGESTION, 900 words FAIL, counting the **body only** — everything after **Length.** 600 words SUGGESTION, 900 words FAIL, counting the **body only** — everything after