Repository navigation
Closed
Copy link
Description
Part 2 of 3 of #16760. Refs #15703.
Problem
docs-hygiene:extract-ssot names npx markdownlint-cli2 as the markdown lint command (R4), points at code-refactor tools, and uses bash, Python, MSBuild, JSON and YAML examples and an unsourced third-party fact.
Rows (5: R11 4, R4 1)
| Row | Rule | Kind | Cited at (as of 5b66a7f) | Fact |
|---|---|---|---|---|
| F0168 | R4 | K3 | plugins/docs-hygiene/skills/extract-ssot/context/execution-checklist.md:45,72,87 |
npx markdownlint-cli2 as the lint command |
| F0169 | R11 | K5 | .../extract-ssot/SKILL.md:31,48 (also .../extract-ssot/context/anti-patterns.md:37) |
Roslyn / ts-morph / IDE rename as the code-refactor tools |
| F0170 | R11 | K7 | .../extract-ssot/actions/identify.md:173,215 (also .../extract-ssot/context/lessons.md:143,155) |
bash source, Python import, MSBuild <Import>, JSON $ref |
| F0171 | R11 | K7 | .../extract-ssot/context/anti-patterns.md:85 |
&dotnet-build-defaults as a YAML anchor example |
| F0172 | R11 | K5 | .../extract-ssot/context/decision-framework.md:67 |
"GitHub Copilot 4000-char hard truncation" cited with no pointer |
Files
- Cut:
plugins/docs-hygiene/skills/extract-ssot/SKILL.md,.../actions/identify.md,.../context/{execution-checklist,anti-patterns,lessons,decision-framework}.md. - Outside references at d46efa9: none by full path.
Rules this part follows (from #16760, rules revision 5)
- R11 (shipped knowledge): model-read K2, K3, K4, K5 or K7 text. Generic text replaces it only at a routing site where the skill still takes a language-specific step; anywhere else it is deleted with no replacement. An item kept only because a removed item consumes it goes in the same pull request.
- R4 (consumer default): the value picks a tool or library for the consumer. It goes: no bundled default survives (ADR 0101 decision 2, "Ship no bundled default"); the choice is resolved from the consumer through
docs/contracts/ecosystem-resolution/. - R8 (measured fact): cut it like the other rows and mark it in the pull request body as pending its targeted case; the host session's eval (below) decides whether it comes back, annotated
portability-ok: measured <case-id>. - AC1's named exceptions are the kept classes of ADR 0101 (
docs/adr/0101-resolve-ecosystem-specifics-from-the-consumer-repository.md, Decision and the 2026-11-17 amendment). Bundled defaults that pick a tool, command or library are retired wherever they appear (Interview Q32, D4 of the Brief). - Line numbers below were read at
5b66a7faand may have moved; find each row by its cited text.
After the pull request opens (host session, not the lane)
The lane opens the pull request with Closes this issue and stops; it adds no label. The pull request stays held for the eval:
- Hold line: a sweep or host session adds
do-not-mergeand posts, from a listed human's account, a comment with<!-- pr-hold reason=eval -->on a line of its own. - Targeted case per changed skill: one before-and-after case on
sonnetat 3 runs a side,--case,--runs 3, a--max-cost-usdceiling;opusonly to confirm a sonnet loss; a new case gets a 1 to 3 run smoke first; start no batch after a usage-limit error (owner decision of 2026-11-16). - Controls: the owner's Q53 decision of 2026-11-17 (owner-decisions.md L202) reads: "each cut pull request is gated on a no-loss compare alone, with no wrong-text side". It supersedes Cut the model-read ecosystem specifics from docs-hygiene #16760's Controls line and its AC7 sentence ("each partial cut carries a detection-control result"). A whole-page deletion still states its predicted outcome in the pull request body before the first batch, and the record says the case cannot detect wrong text.
- On a LOSS reading: a trace read of each dropped case and an
opusconfirm; only a loss traced to the changed text counts. - R8 rows: the row's targeted case with and without it; on a
case dropor a mean fall of 0.15 or more without it, restore the row annotatedportability-ok: measured <case-id>; a deterministic grader states before the run in how many of n runs it must fail. - Record: on a VALID no-loss run, post from a listed human's account
<!-- eval-pair verdict=no-loss validity=VALID head=<40-hex head SHA> -->naming the current head, with no "do not merge" text (docs/contracts/loop-lane/README.md, "Cross-lane PR hold"). pr-merge's "Release eval holds whose record matches the head" step (.github/scripts/pr-merge/release-eval-hold.mjs) then removesdo-not-merge; a later push needs a new record.
Out of scope
Rows outside this part's table, the parent's kept rows, every other plugin, toolchain's bundled defaults (#15733), and widening the portability gate (#15732).
Done when
- Every row in this part's table is cut or replaced at a routing site, and no bundled lint command survives; a row whose cited text is already gone on
mainis listed as GONE. - The pull request body states this part's row count (5) and lists every row id with its rule and outcome.
- Each R11 row's script-reader search is quoted in the pull request body; a row whose file a script reads is not cut, and is listed in the pull request body under a
Script readersheading. - The pull request body names, for extract-ssot, the existing eval case that reads the cut text, or says none does.
- The pull request body says, for each changed file, whether the cut deletes the whole page or part of it.
- AC10: no new enforcement-placing skill is added.
Metadata
Metadata
Assignees
Labels
No labels
Type
Fields
Work status
needs-triage
Priority
medium
Activity
github-actions commentedon Nov 21, 2026
Size: Small
Complexity: Low
Uncertainty: Known
Flags: none
Blocked by: none
Blast radius: the extract-ssot skill's SKILL.md, one action page and four context pages under plugins/docs-hygiene; read by the model when the skill runs.
Reversible: yes; revert the pull request, or restore a single row annotated
portability-ok: measured <case-id>if its eval shows a loss.Open questions: none
I understood this as part 2 of 3 of #16760 (refs #15703): cut or replace 5 rows (F0168 to F0172) of ecosystem-specific text in extract-ssot, including the bundled
npx markdownlint-cli2lint command. The rules, files and done-when are exact. The host-session eval steps are not lane-checkable, so they don't hold triage. No open issue duplicates it. #17773 is the sibling docs-hygiene part for other skills, and no merged pull request already covers extract-ssot.Automated triage. A maintainer reviews it.
melodic-automation-lanes commentedon Nov 21, 2026
{"v":1,"actor_id":337595936,"title_sha256":"8133b0b1b5e07799f481286eda7f0bb9de208c1e9343efa6843c3f918542a5ef","body_sha256":"78b6c37fd8e575ee1e6de37cbb88317361e0f1713865175bb2a44b1e98a40053"}
melodic-automation-lanes commentedon Nov 21, 2026
{"v":1,"actor_id":337595936,"title_sha256":"8133b0b1b5e07799f481286eda7f0bb9de208c1e9343efa6843c3f918542a5ef","body_sha256":"78b6c37fd8e575ee1e6de37cbb88317361e0f1713865175bb2a44b1e98a40053"}
github-actions commentedon Nov 21, 2026
github-actions commentedon Nov 21, 2026