Split out a treatment
Type: kb/types/instruction.md
Leave the artifact with the shortest correct passage, and retain the full argument in a separate file that no pass over the artifact will read.
Effort: simple. Formatting and placement once the parent supplies the passage and the discussion text.
- Write the minimal passage into the artifact: the claim, its one-sentence mechanism, and any term the passage introduces, glossed in place.
- Write the full treatment as its own file in the same collection, with the collection's frontmatter, a banner naming the passages it stands behind, and a link to the artifact. It may carry tables, the discussion's corrections of earlier wording, and open items.
- Do not link from the artifact to the treatment. The treatment links in; the artifact does not link out. This is what keeps it out of the context of any pass that follows the artifact's links.
- Add the treatment to the collection's index with one line saying it is a supplement to the artifact.
Report: the passage as written, the treatment's path, and what the treatment holds that the passage does not.
Preserve: the artifact's link grammar and the collection rule against footer link tables; weave the treatment's links into prose.