refactor(skills): retrofit the corpus to the ADR-0020 context contract #129
@@ -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
|
||||
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
|
||||
3,000 words of references across five mutually exclusive invocations. Its whole-file count is 554
|
||||
words — cite 421 when calibrating a body, or the conflation this section warns against reappears
|
||||
The reference shape in this repo is `apm-workflow`: a **237-word body** dispatching to roughly
|
||||
3,200 words of references across five mutually exclusive invocations. Its whole-file count is 304
|
||||
words — cite 237 when calibrating a body, or the conflation this section warns against reappears
|
||||
in the finding itself.
|
||||
|
||||
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.
|
||||
|
||||
## Gotchas sections
|
||||
|
||||
@@ -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
|
||||
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
|
||||
references. Calibrate against 421: that file's whole-file count is 554 words, and aiming at that
|
||||
file. Exemplar: the `apm-workflow` skill — a **237-word body** dispatching to 3,222 words of
|
||||
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%.
|
||||
|
||||
**Length.** 600 words SUGGESTION, 900 words FAIL, counting the **body only** — everything after
|
||||
|
||||
@@ -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
|
||||
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
|
||||
3,000 words of references across five mutually exclusive invocations. Its whole-file count is 554
|
||||
words — cite 421 when calibrating a body, or the conflation this section warns against reappears
|
||||
The reference shape in this repo is `apm-workflow`: a **237-word body** dispatching to roughly
|
||||
3,200 words of references across five mutually exclusive invocations. Its whole-file count is 304
|
||||
words — cite 237 when calibrating a body, or the conflation this section warns against reappears
|
||||
in the finding itself.
|
||||
|
||||
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.
|
||||
|
||||
## Gotchas sections
|
||||
|
||||
@@ -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
|
||||
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
|
||||
references. Calibrate against 421: that file's whole-file count is 554 words, and aiming at that
|
||||
file. Exemplar: the `apm-workflow` skill — a **237-word body** dispatching to 3,222 words of
|
||||
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%.
|
||||
|
||||
**Length.** 600 words SUGGESTION, 900 words FAIL, counting the **body only** — everything after
|
||||
|
||||
Reference in New Issue
Block a user