From 4806b832650119cbb70d828ea3db081d99dc845e Mon Sep 17 00:00:00 2001 From: Brummel Date: Sun, 31 May 2026 16:51:56 +0200 Subject: [PATCH] =?UTF-8?q?audit(glossary):=20close=20cycle=20=E2=80=94=20?= =?UTF-8?q?glossary=20skill=20drift-clean?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cycle-close tidy for the glossary-skill cycle (59c2f4b..4fd5408). Architect drift review (sole gate — repo ships no .claude/dev-cycle-profile.yml, so commands.regression is empty and the regression step is a documented no-op): - [medium] FIXED. docs/agent-template.md said the Iron Law is rendered 'as a numbered list' (the schematic placeholder at l.37 and the prose at the § Iron Law section), but all 13 existing agents render it as a code-fenced block of short imperative lines — and the cycle's new glossary-extractor.md correctly followed that universal convention. So the drift was the template wording, stale relative to every one of its instances, not the new file. Resolution: align the template to reality (both spots now say 'a code-fenced block of short imperative lines'). The new agent file was carry-on — 'fixing' it to a numbered list would have made it the lone deviant among 14 agents, i.e. introducing drift, not removing it. - [low] CARRY-ON. README now classes issue/glossary as 'utility skills' but that taxonomy is not mirrored in issue/SKILL.md's or glossary/SKILL.md's own frontmatter. Accepted as low-severity: the invocation-class label is a README-level descriptor; mandating every skill self-declare its class in frontmatter is gold-plating with no consumer. Revisit only if a tool starts keying off a per-skill class. What holds: single-sourcing preserved (the new skill cites glossary-convention.md and restates no rule; paths.glossary semantics defer to profile-schema.md); authority consistent across the boss sentence, the convention, and the skill's Authority section; the utility-vs-phase distinction held (no claim that glossary is a pipeline phase); glossary-extractor.md conforms to agent-template.md. Cycle is drift-clean. Not a milestone close (no milestone fieldtest run; see docs/pipeline.md § Milestone-close gate). Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/agent-template.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/agent-template.md b/docs/agent-template.md index 052e51f..da93b20 100644 --- a/docs/agent-template.md +++ b/docs/agent-template.md @@ -34,7 +34,8 @@ directories directly — context curation lives at the skill level> ## Iron Law - + ## The Process @@ -149,8 +150,8 @@ was told. ### Iron Law -Numbered list of the non-negotiable rules. These are the rules -the agent will violate if it rationalises. Calibrate to past +A code-fenced block of short, imperative rules. These are the +rules the agent will violate if it rationalises. Calibrate to past failure modes — abstract rules don't land; rules anchored to a named past mistake do.