Skip to content

chore: execute catalog stocktake and drop legacy host name - #19

Merged
kuker24 merged 1 commit into
mainfrom
chore/stocktake-execution-1.8.3
Sep 14, 2026
Merged

kuker24 merged 1 commit into
mainfrom
chore/stocktake-execution-1.8.3

Conversation

@kuker24

@kuker24 kuker24 commented Sep 14, 2026

Copy link
Copy Markdown
Owner

Runs the verdict protocol that PR #18 installed but never executed, and clears the currency findings it surfaced.

Stocktake

docs/stocktake-1.8.3.md records all 62 items, one verdict each: 57 KEEP, 2 COMPRESS, 3 UPDATE, 0 MERGE, 0 RETIRE. Tree measured at 46 model-invoked + 16 manual, matching vendor/skill-policy.json and vendor/skill-allowlist.txt.

MERGE is zero on evidence. Highest lexical description overlap is matt-code-review ~ interrogate at 0.359 Jaccard, under the 50% warn line already enforced in tests/test_skills.py. Every near pair is a fenced sibling.

RETIRE is zero because no no-skill baseline was run. A baseline cannot come from a session that already has the catalog loaded, so five candidates (research, prototype, grilling, wait-what, ask-matt) are recorded as blocked on the eval-harness A/B gate rather than retired on argument.

Currency

GrokBuild is the predecessor product name, surviving in five bodies while absent from README and docs. Removed where it named the host, including the ask-matt description that loads on every session start. Left intact where it names an image/video tool contract; renaming that has a wider blast radius and is filed as a follow-up.

Two contradictions against rules/00-routing.md also fixed: chrome-devtools-axi offered a $HOME/.grok/bin fallback against the "do not depend on ~/.grok" rule, and grill-with-docs offered /implement which the rule says does not exist.

Compression

  • grill-with-docs 120 → 77. The whole body was duplicated behind an orphan overlay marker dating to the 1.0.0 bootstrap, referenced nowhere in the engine. The halves differed, so the result is a reconciled superset, not a truncation.
  • codebase-design 115 → 97. Two ASCII diagrams restated adjacent prose.
  • chrome-devtools-axi 75 → 66 as a side effect of deduplicating its contract block; counted once under UPDATE.

Left alone: to-tickets, adhd, emil-design-eng, full-performance-audit. Their length is numeric gates and sequencing judgment.

Also

README documents the optional stitch MCP that shipped in 1.8.2 but was never listed beside serena and exa. GitHub repo description updated to 62 routed skills; topics untouched.

Verification

  • python3 -m unittest tests.test_skills — 10 OK
  • python3 -m unittest discover -s tests — 315 OK (skipped=2)
  • python3 tests/test_isolation.py — 2 OK
  • python3 -m compileall -q lib tests — clean
  • git diff --check — clean

The four FAILED CHECKSUM_MISMATCH-style lines in suite output are pre-existing negative-path log noise from test_release_artifacts; verified identical on clean main.

Not in scope

No new skills, no new MCP, no new dependencies. VERSION stays 1.8.2, no 1.8.3 heading opened, no tag, no release. Historical CHANGELOG numbers untouched (CHANGELOG.md diff is 6 additions, 0 deletions). The 28 skills that defer licensing to vendor/license-audit.json were not given frontmatter keys.

Follow-ups for a maintainer

  1. Run the A/B gate on the five blocked candidates before any RETIRE.
  2. Decide whether the GrokBuild image_gen tool-family name should be renamed catalog-wide or documented as intended.
  3. impeccable frontmatter says Apache 2.0 while the audit file says Apache-2.0; the test normalizes, but aligning would drop a special case.

PR #18 installed the verdict protocol but never ran it. This pass runs it
across all 62 items and records the result in docs/stocktake-1.8.3.md:
one verdict per item, 57 KEEP, 2 COMPRESS, 3 UPDATE, 0 MERGE, 0 RETIRE.

MERGE is zero on measured evidence, not sentiment. The highest lexical
description overlap in the catalog is matt-code-review ~ interrogate at
0.359 Jaccard, below the 50% warn line already enforced in tests. Every
near pair is a fenced sibling.

RETIRE is zero because no no-skill baseline was run. A baseline cannot be
produced from a session that already has the catalog loaded, so five
candidates (research, prototype, grilling, wait-what, ask-matt) are
recorded as blocked on the eval-harness A/B gate rather than retired on
argument alone.

GrokBuild is the predecessor product name and survived in five bodies
while appearing nowhere in README or docs. Removed where it named the
host: the ask-matt description, which loads on every session start, a
chrome-devtools-axi heading, adhd, and one visual-studio line claiming
GrokBuild owns the tools. Left intact where it names an image/video tool
contract rather than the host; renaming that has a wider blast radius and
is recorded as a follow-up.

Two currency contradictions against rules/00-routing.md also fixed:
chrome-devtools-axi offered a $HOME/.grok/bin fallback while the rule
says not to depend on ~/.grok at runtime, and grill-with-docs offered
/implement while the rule says no such user skill exists.

Compressed two bodies whose length carried no extra judgment.
grill-with-docs 120 -> 77: the entire body was duplicated behind an
orphan overlay marker dating to the 1.0.0 bootstrap and referenced
nowhere in the engine. The halves differed, so the surviving text is a
reconciled superset, not a truncation. codebase-design 115 -> 97: two
ASCII diagrams restated the adjacent sentence. to-tickets, adhd,
emil-design-eng, and full-performance-audit were left alone because
their length is numeric gates and sequencing judgment.

chrome-devtools-axi also shrank 75 -> 66, but as a consequence of
deduplicating its contract block. It is counted once, under UPDATE.

README documents the optional stitch MCP that shipped in 1.8.2 but was
never listed beside serena and exa.

No new skills, no new MCP, no new dependencies. VERSION stays 1.8.2 and
no 1.8.3 heading is opened; entries remain under Unreleased.
@kuker24
kuker24 merged commit 3365b05 into main Sep 14, 2026
10 checks passed
@kuker24
kuker24 deleted the chore/stocktake-execution-1.8.3 branch September 14, 2026 10:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant