@adia-ai/adia-ui-forge 0.1.3 → 0.8.0

package/skills/adia-ui-llm/references/teach-protocol.md

@@ -1,78 +0,0 @@
-# §Teach protocol — mode 8
-
-The extensibility binding for "make sure `adia-ui-llm` knows about X" / "train the skill on a new provider quirk" / "absorb this adapter pitfall into adia-ui-llm". This is the producer-side teach surface: it lands knowledge about MAINTAINING `@adia-ai/llm`, never about consuming it (consumer knowledge routes to the separate `adia-ui-factory` consumer skill).
-
-The decision tree below is mechanized in `scripts/teach-route.mjs` (the authoritative routing); this prose mirrors the branches for human readers and adds worked examples + anti-patterns.
-
----
-
-## The first question — does it land in the skill at all?
-
-The skill is a CITATION layer, not a KNOWLEDGE layer. Much "new knowledge" about the LLM client is actually a **source edit**, not a skill edit:
-
-- A new field in a provider's response mapping → edit `packages/llm/src/adapters/<name>.ts` (`parseResponse` / `parseStream`). The skill changes only if a cross-adapter RULE changed.
-- A new model id → edit `packages/llm/src/models.ts`. The skill changes only if a registry rule changed (e.g. a new id-naming convention `detectProvider` must learn).
-- A new default → edit the source map (`models.ts:DEFAULT_MODEL` or `llm-bridge.ts:DEFAULT_MODELS`). The skill cites the maps; it doesn't store the values.
-
-If the payload is a fact the source already encodes (or should), the landing is the source — and the skill may not change at all. Land a skill patch only when the knowledge is a durable RULE, pitfall, or procedure a maintainer needs surfaced.
-
-## The decision tree (branches)
-
-First match wins. The landing is a reference file in this skill's `references/` directory (named bare below), or a non-reference landing (`(source)` / `(journal)` / `SKILL.md`). The mechanized router in `scripts/teach-route.mjs` emits the same target as a skill-root-relative path.
-
-| Branch | Fires when the payload is about… | Landing |
-| --- | --- | --- |
-| `source-edit` | a per-adapter field/value the source encodes (response field, a model id, a default value) | `(source) packages/llm/src/...` — not a skill landing |
-| `add-provider` | a new step or gotcha in adding a 4th provider | `add-a-provider.md` |
-| `streaming` | the SSE parser, the `StreamChunk` protocol, a chunk-type, `[DONE]` / framing | `streaming-sse.md` |
-| `model-registry` | the `MODELS` shape, `DEFAULT_MODEL`, `detectProvider` rules | `model-registry.md` |
-| `bridge-facade` | `chat`/`streamChat`/`createClient`, `createAdapter`, the bridge, the stub, `maxTokens`, lazy-load | `bridge-facade.md` |
-| `proxy-boundary` | smart vs passthrough proxy, the production-host path, key-in-browser safety | `browser-proxy-boundary.md` |
-| `adapter-contract` | a cross-adapter shape rule, `usage` mapping, raw `stopReason`, `buildRequest` discipline (DEFAULT) | `adapter-contract.md` |
-| `methodology` | a posture / mission shift or a new §SelfAudit axis | `SKILL.md` (inline) |
-| `journal` | a one-off debugging arc story (NEGATIVE — not the skill) | `(journal)` |
-
-`adapter-contract` is the default branch: an unclassified maintenance fact most often belongs with the adapter contract, and re-classifies from there.
-
-## The five-step landing procedure
-
-1. **Audit before patching.** Run `node scripts/audit-llm-roster.mjs` to confirm the skill is drift-free first; you don't want to land a patch on top of existing drift.
-2. **Author the patch** in the branch's target file. Keep it a citation — name the `packages/llm/src/...` path + type, don't paste the code.
-3. **Wire the activation surface.** If the patch adds a capability, add/adjust the §ColdStartTriage row or a §Posture line so the knowledge is reachable. An orphaned reference nobody routes to is dead weight.
-4. **Version + CHANGELOG.** Bump `skill.json` + the SKILL.md frontmatter `version` together (one MINOR for a new rule/capability; one PATCH for a clarification — never bundle both into one bump), and prepend a CHANGELOG entry.
-5. **Verify.** Run `node scripts/audit-llm-roster.mjs --strict` (0 drift) AND close the PEV loop — the underlying knowledge should be verifiable against the real package (`npm run build` + a `chat()` / stub round-trip). See `## §Plan-Execute-Verify` in SKILL.md.
-
-## Anti-patterns
-
-- **Append-only landing.** Tacking a paragraph onto the nearest file without checking whether it duplicates an existing rule or belongs in the source. Audit first.
-- **Source duplication.** Restating what an adapter's `parseResponse` already encodes. If the source is the truth, cite it; don't copy it into prose that will drift.
-- **Orphan triggers.** A new reference with no §ColdStartTriage row or posture line pointing at it.
-- **Capability-menu lies.** A menu row promising a mode whose reference doesn't cover it.
-- **MINOR + PATCH bundling.** Two unrelated changes in one version bump muddies the CHANGELOG.
-- **One-way thinking.** The most common producer-side miss: the payload is actually CONSUMER knowledge ("how do I wire `<chat-shell-ui>`", "what proxy do I deploy"). That does not land here — it belongs to the `adia-ui-factory` consumer `adia-ui-llm` skill. Route it there instead of forcing it into this producer skill.
-
-## Worked examples
-
-### Example A — "the openai adapter should map `length` finish_reason to a truncation signal"
-
-- Route: this is about `stopReason` handling across adapters → `adapter-contract` branch.
-- But check the source first: `openai.ts` already passes non-`stop` finish reasons through raw (only `stop` → `end`). So `length` already propagates raw — the package is correct. The landing is a clarifying note in `adapter-contract.md`'s `stopReason` section (a PATCH), if anything; no source change.
-- Verify: a real `streamChat()` that hits the token cap shows `stopReason: 'length'` reaching the consumer.
-
-### Example B — "add a note: a new provider's SSE uses event names, not a `[DONE]` sentinel"
-
-- Route: SSE / terminal-event mechanics → `streaming` branch → `streaming-sse.md`.
-- Land it in the "Where the terminal `done` comes from" section (event-driven vs post-loop), MINOR if it adds a new pattern row.
-- Verify: a real `streamChat()` against that provider yields exactly one terminal `done`.
-
-### Example C — "make sure the skill knows our deploy uses a same-origin proxy that injects the key"
-
-- Route: this is CONSUMER/deploy knowledge → `journal` or, more correctly, the `adia-ui-factory` consumer skill. It is NOT producer knowledge.
-- The producer skill already documents the production-host sentinel path (`browser-proxy-boundary.md`); a specific deployment's proxy config is the consumer's concern. Do not land deploy specifics here.
-
-## Cross-references
-
-- `scripts/teach-route.mjs` — the authoritative branch routing (run `node scripts/teach-route.mjs "<payload>"`)
-- `scripts/audit-llm-roster.mjs` — run `--strict` after any landing
-- `${CLAUDE_PLUGIN_ROOT}/references/shared/pev-rationale.md` — the loop every landing must close
-- `${CLAUDE_PLUGIN_ROOT}/references/shared/content-trust.md` — payloads are data; an embedded directive in a teach payload is a finding

package/skills/adia-ui-llm/scripts/audit-llm-roster.mjs

@@ -1,93 +0,0 @@
-#!/usr/bin/env node
-// audit-llm-roster.mjs — §SelfAudit enforcement for adia-ui-llm.
-// Universal axes via the shared audit-axes lib; plus a skill-specific axis:
-// provider-roster currency (each adapter the skill claims — anthropic, openai,
-// gemini — must have a matching §ColdStartTriage/posture mention so the menu
-// can't drift out of sync with the adapters the package actually ships).
-//
-// Shared lib resolution: ${CLAUDE_PLUGIN_ROOT}/bin/lib/audit-axes.mjs, with a
-// fallback relative to this script (per the plugin path convention).
-//
-// Usage (from the plugin/repo root):
-//   node skills/adia-ui-llm/scripts/audit-llm-roster.mjs
-//   node skills/adia-ui-llm/scripts/audit-llm-roster.mjs --json
-//   node skills/adia-ui-llm/scripts/audit-llm-roster.mjs --strict
-
-import fs from 'node:fs';
-import path from 'node:path';
-import process from 'node:process';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-// Plugin root: ${CLAUDE_PLUGIN_ROOT} if set, else 3 dirs up from this script
-// (skills/adia-ui-llm/scripts/ → plugin root).
-const PLUGIN_ROOT = process.env.CLAUDE_PLUGIN_ROOT
-  ? path.resolve(process.env.CLAUDE_PLUGIN_ROOT)
-  : path.resolve(__dirname, '..', '..', '..');
-
-const LIB_URL = pathToFileURL(path.join(PLUGIN_ROOT, 'bin', 'lib', 'audit-axes.mjs')).href;
-const { runUniversalAxes, formatResults } = await import(LIB_URL);
-
-// Skill layout: skills/<name>/ under the plugin root (matches run-skill-evals.mjs).
-const SKILL_DIR = path.join(PLUGIN_ROOT, 'skills', 'adia-ui-llm');
-const SKILL_MD = path.join(SKILL_DIR, 'SKILL.md');
-const SKILL_JSON = path.join(SKILL_DIR, 'skill.json');
-
-// The provider adapters this skill maintains. Each MUST be referenced in
-// SKILL.md so the cold-start menu / posture stays in sync with the package.
-const PROVIDERS = ['anthropic', 'openai', 'gemini'];
-
-function parseArgs(argv) {
-  return { json: argv.includes('--json'), strict: argv.includes('--strict') };
-}
-
-function readSafe(p) {
-  try { return fs.readFileSync(p, 'utf8'); } catch { return ''; }
-}
-
-function axisProviderRosterCurrency() {
-  const md = readSafe(SKILL_MD);
-  const findings = [];
-  for (const name of PROVIDERS) {
-    if (md.includes(name)) {
-      findings.push({ type: 'provider-present', message: `${name}: referenced in SKILL.md — correct`, name });
-    } else {
-      findings.push({
-        type: 'provider-missing',
-        message: `${name}: adapter is shipped by the package but not referenced in SKILL.md`,
-        name,
-      });
-    }
-  }
-  const driftCount = findings.filter(f => f.type !== 'provider-present').length;
-  return {
-    axis: 'providerRosterCurrency',
-    axis_num: 9,
-    status: driftCount > 0 ? 'drift' : 'ok',
-    findings,
-    summary: driftCount > 0 ? `${driftCount} provider(s) unreferenced` : 'all adapters referenced in SKILL.md',
-  };
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const ctx = { skillDir: SKILL_DIR, skillMd: SKILL_MD, skillJson: SKILL_JSON, repoRoot: PLUGIN_ROOT };
-  const { results: universal } = runUniversalAxes(ctx);
-  const axis9 = axisProviderRosterCurrency();
-  const allResults = [...universal, axis9];
-  const driftCount = allResults.filter(r => r.status === 'drift').length;
-
-  if (args.json) {
-    console.log(JSON.stringify({ results: allResults, driftCount }, null, 2));
-    if (args.strict && driftCount > 0) process.exit(1);
-    return;
-  }
-
-  console.log(`[audit-llm-roster] adia-ui-llm §SelfAudit — ${driftCount} drifting axis/axes`);
-  console.log(formatResults(allResults));
-  if (driftCount === 0) console.log('\n✓ All clean.');
-  if (args.strict && driftCount > 0) process.exit(1);
-}
-
-main();

package/skills/adia-ui-llm/scripts/teach-route.mjs

@@ -1,119 +0,0 @@
-#!/usr/bin/env node
-// teach-route.mjs — Mechanized §Teach decision tree for adia-ui-llm.
-// Maps a "make sure the skill knows about X" payload to its landing target.
-// Composes from the shared teach-router lib; the prose tree in
-// references/teach-protocol.md mirrors these branches for human readers.
-//
-// Shared lib resolution: ${CLAUDE_PLUGIN_ROOT}/bin/lib/teach-router.mjs, with a
-// fallback relative to this script.
-//
-// Usage (from the plugin/repo root):
-//   node skills/adia-ui-llm/scripts/teach-route.mjs "add a new provider adapter"
-//   node skills/adia-ui-llm/scripts/teach-route.mjs --list
-//   node skills/adia-ui-llm/scripts/teach-route.mjs --payload="<payload>" [--json]
-
-import path from 'node:path';
-import process from 'node:process';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-const PLUGIN_ROOT = process.env.CLAUDE_PLUGIN_ROOT
-  ? path.resolve(process.env.CLAUDE_PLUGIN_ROOT)
-  : path.resolve(__dirname, '..', '..', '..');
-
-const LIB_URL = pathToFileURL(path.join(PLUGIN_ROOT, 'bin', 'lib', 'teach-router.mjs')).href;
-const { buildRouter, describeRouter } = await import(LIB_URL);
-
-// Branches: first match wins. `target` is the landing file (relative to skill
-// root) — or "(source)" / "(journal)" / "SKILL.md" for non-reference landings.
-// Mirrors the table in references/teach-protocol.md.
-export const branches = [
-  {
-    id: 'source-edit',
-    label: 'Per-adapter field/value the source encodes (NOT a skill landing)',
-    match: [/response field/i, /model id/i, 'default value', /new field/i, 'source edit', 'parseresponse field'],
-    target: '(source) packages/llm/src/',
-    confidence: 'high',
-  },
-  {
-    id: 'add-provider',
-    label: 'New step / gotcha in adding a 4th provider',
-    match: ['add a provider', 'add a new provider', '4th provider', 'fourth provider', 'new adapter step'],
-    target: 'references/add-a-provider.md',
-    confidence: 'high',
-  },
-  {
-    id: 'streaming',
-    label: 'SSE parser / StreamChunk protocol / chunk type',
-    match: ['sse', 'stream chunk', 'streamchunk', 'chunk type', '[done]', 'snapshot', 'streaming protocol', /stream(ing)? parser/i],
-    target: 'references/streaming-sse.md',
-    confidence: 'high',
-  },
-  {
-    id: 'model-registry',
-    label: 'MODELS shape / DEFAULT_MODEL / detectProvider rule',
-    match: ['models catalog', 'model registry', 'default_model', 'detectprovider', 'detect provider', 'grouped options', 'chat-input'],
-    target: 'references/model-registry.md',
-    confidence: 'high',
-  },
-  {
-    id: 'bridge-facade',
-    label: 'Facade / bridge / stub / maxTokens / lazy-load',
-    match: ['createadapter', 'create adapter', 'createclient', 'create client', 'bridge', 'stub', 'maxtokens', 'max tokens', 'lazy-load', 'lazy load', 'chatresult', 'chatopts'],
-    target: 'references/bridge-facade.md',
-    confidence: 'high',
-  },
-  {
-    id: 'proxy-boundary',
-    label: 'Proxy flavors / production-host path / key-in-browser safety',
-    match: ['proxy', 'passthrough', 'smart proxy', 'proxyurl', 'production host', 'browser key', 'key in browser', 'cors'],
-    target: 'references/browser-proxy-boundary.md',
-    confidence: 'high',
-  },
-  {
-    id: 'adapter-contract',
-    label: 'Cross-adapter shape rule / usage mapping / raw stopReason / buildRequest (DEFAULT)',
-    match: ['adapter contract', 'buildrequest', 'build request', 'usage mapping', 'stopreason', 'stop reason', 'parseresponse', 'adapter shape'],
-    target: 'references/adapter-contract.md',
-    confidence: 'medium',
-  },
-  {
-    id: 'methodology',
-    label: 'Posture / mission shift or new §SelfAudit axis (inline SKILL.md)',
-    match: ['posture', 'methodology', 'principle', 'mission', 'new selfaudit axis', 'self-audit axis'],
-    target: 'SKILL.md',
-    confidence: 'medium',
-  },
-  {
-    id: 'journal',
-    label: 'One-off arc story (NEGATIVE — journal, not the skill)',
-    match: ['arc story', 'debugging story', 'one-off', 'how i debugged', 'journal'],
-    target: '(journal)',
-    confidence: 'high',
-  },
-];
-
-export const router = buildRouter({ branches, defaultBranch: 'adapter-contract' });
-
-// ─── CLI ──────────────────────────────────────────────────────────────────────
-
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-  const args = process.argv.slice(2);
-  if (args.includes('--list')) {
-    console.log(describeRouter(router, branches));
-    process.exit(0);
-  }
-  const payloadFlag = args.find(a => a.startsWith('--payload='));
-  const payload = payloadFlag
-    ? payloadFlag.slice('--payload='.length)
-    : args.filter(a => !a.startsWith('--')).join(' ');
-  if (!payload) {
-    console.error('Usage: node teach-route.mjs "<payload describing the new knowledge>"');
-    console.error('       node teach-route.mjs --payload="<payload>" [--json]');
-    console.error('       node teach-route.mjs --list');
-    process.exit(1);
-  }
-  const { branch, target, confidence, label } = router(payload);
-  console.log(JSON.stringify({ payload, branch, label, target, confidence }, null, 2));
-}

package/skills/adia-ui-llm/skill.json

@@ -1,33 +0,0 @@
-{
-  "name": "adia-ui-llm",
-  "version": "0.1.0",
-  "description": "Maintainer (PRODUCER) skill for @adia-ai/llm — the provider-agnostic LLM client at packages/llm/ that the adia-ui chat-shell and the A2UI generation pipeline depend on. Owns the provider adapters (anthropic / openai / gemini), the shared SSE parser, the model registry (models.ts), the unified chat() / streamChat() / createClient() facade, the createAdapter() bridge, the browser(proxyUrl)+Node duality, and StubLLMAdapter. Every mode names a real verify target (the built package, a real chat() round-trip, or the deterministic stub). Use whenever the user wants to ADD A PROVIDER ADAPTER / MODIFY AN ADAPTER / EVOLVE THE MODEL REGISTRY / WORK ON SSE STREAMING / CHANGE THE BRIDGE-FACADE CONTRACT / TOUCH THE BROWSER-PROXY BOUNDARY / FIX THE STUB. Triggers on \"add a new LLM provider\", \"fix the @adia-ai/llm SSE adapter\", \"the anthropic adapter drops cache tokens\", \"add a model to the registry\", \"streamChat yields a wrong chunk\", \"change chat()/streamChat()\", \"passthrough vs smart proxy\", \"stopReason normalization\", \"stub returns wrong A2UI\", \"teach adia-ui-llm\". Does NOT trigger for: WIRING the client into an app or chat box (CONSUMER side — the adia-ui-factory plugin's adia-ui-llm skill), generation-pipeline / corpus internals (adia-ui-a2ui), authoring web-components or the in-monorepo bridge surface against an unchanged client (adia-ui-authoring), cutting a release (adia-ui-release), or general LLM-streaming tutorials.",
-  "status": "stable",
-  "authors": ["kim.granlund"],
-  "codeowners": [],
-  "tags": ["adia-ui", "llm", "anthropic", "openai", "gemini", "sse", "streaming", "model-registry", "provider-adapter", "chat", "streamchat", "createadapter", "proxy", "stub", "provider-agnostic"],
-  "depends_on": [],
-  "peer_skills": ["adia-ui-authoring", "adia-ui-a2ui", "adia-ui-release", "adia-ui-gen-review", "adia-ui-dogfood"],
-  "environment": {
-    "portable": false,
-    "requires": ["the @adia-ai monorepo with packages/llm/ (src/adapters/{anthropic,openai,gemini,sse,index}.ts, src/models.ts, src/llm-bridge.ts, src/llm-stub.ts)"],
-    "rationale": "The @adia-ai/llm client source exists only in the @adia-ai monorepo; every verify command (npm run build for the package, a real chat()/streamChat() round-trip, the stub) and every audited source path (packages/llm/**) is substrate-side."
-  },
-  "files": [
-    "SKILL.md",
-    "CHANGELOG.md",
-    "skill.json",
-    "references/adapter-contract.md",
-    "references/streaming-sse.md",
-    "references/model-registry.md",
-    "references/bridge-facade.md",
-    "references/browser-proxy-boundary.md",
-    "references/add-a-provider.md",
-    "references/teach-protocol.md",
-    "scripts/audit-llm-roster.mjs",
-    "scripts/teach-route.mjs",
-    "evals/routing-corpus.json",
-    "evals/adversarial-corpus.json",
-    "evals/teach-routing-cases.json"
-  ]
-}

package/skills/adia-ui-ops/CHANGELOG.md

@@ -1,291 +0,0 @@
-# Changelog — adia-ui-ops
-
-## [1.2.4] stable — 2026-06-09
-
-**PATCH** — Site-deploy pre-build step: build `@adia-ai/llm` before `build:site`.
-
-- `deploy-playbooks.md` §Hardened-`--delete`-deploy-sequence step 1: added a fresh-worktree
-  pre-build step — `npm run build -w @adia-ai/llm` **before** `build:site`. The `llm` package
-  compiles its JS at publish (outputs gitignored), so a fresh worktree has no
-  `packages/llm/index.js`, `build:site` copies nothing, and `/packages/llm/index.js` 404s on
-  the deployed site → **component registration breaks on every `/site/components/*` page**.
-- `deploy-playbooks.md` §`build:site`-DOES-include-src/components callout: added "the one
-  exception" sub-note (llm is publish-built, not source-tree) + the reason step 5 render-checks
-  a `/site/components/*` page (the 404 is invisible to file-presence + the SPA shell).
-- Found **live 2026-06-09** during the v0.7.18 EXE deploy; the **0-delete dry-run proved the
-  file had never been deployed** (standing gap across every prior deploy, not a regression).
-  Arc story lives in `docs/journal/2026/06/2026-06-09.md` §8, not duplicated here.
-
-## [1.2.3] stable — 2026-06-08
-
-**PATCH** — Branch D landing: hardened `--delete` site-deploy sequence.
-
-- `deploy-playbooks.md` §Playbook-deploy-an-update: added the 6-step hardened `--delete` sequence (dry-run + adjudicate every delete → snapshot-first via `cp -al` → deploy → verify the fixture **file** not the route → rollback), plus the "don't panic at the send count" mtime-vs-content note and the "`build:site` DOES include `src/components`" clarification (disproven worry).
-- §Common failures: +1 row (site serves a stale build / new fixtures 404 → `deploy:site` is manual, never run after merge).
-- §Invariants: +2 (snapshot the webroot before any `--delete`; verify a fixture file, never the route).
-- §Current deployments: `ui-kit.exe.xyz` now notes the embedded-app HCC demo + webroot.
-- Grounded in the 2026-06-08 ui-kit deploy (3,572 deletes, snapshot-protected, verified green on both surfaces) — arc story lives in `docs/journal/2026/06/2026-06-08.md` §2 (Branch G), not duplicated here.
-
-## [1.2.2] stable — 2026-05-24
-
-**PATCH** — Audit script rewired to shared library; axis count updated.
-
-- `audit-ops-roster.mjs` now imports `runUniversalAxes` + `formatResults` from `.agents/shared/scripts/lib/audit-axes.mjs`. Inline implementations of axes 2/4/5 removed; script shrinks from 279 → 88 lines. Axis 9 (absorbed-skill roster currency) retained inline.
-- Axis count updated 4 → 9 in SKILL.md §ColdStartTriage verify-target table and structural-gate code comment.
-- Verified: `audit-ops-roster.mjs --strict` exits 0 (9/9 axes clean).
-
-## [1.2.1] stable — 2026-05-22
-
-**PATCH** — Trigger surface expansion: docs-currency / daily audit / currency
-markers vocabulary (ops F1 90% → 95%, routing-eval 90.0% → 93.3%).
-
-Added explicit triggers for ops-cycle vocabulary that wasn't declared
-in the trigger field, causing the legitimate ops phrase to lose to
-adia-ui-a2ui on the v0.2.0 scorer:
-
-  - "docs-currency" / "docs-currency audit" / "daily docs-currency"
-  - "daily audit" / "daily docs"
-  - "currency audit" / "currency markers"
-  - "docs freshness" / "stale docs sweep"
-  - "daily docs-currency audit"
-
-Recovered phrase: `ops-10` "run the daily docs-currency audit" — was
-routing to adia-ui-a2ui (a2ui body had `audit` + `currency` from
-"currency markers" in its frontmatter), now correctly routes to
-adia-ui-ops. Safety-scanned against the corpus: zero non-ops phrases
-reference these tokens.
-
-## [1.2.0] stable — 2026-05-22
-
-**MINOR** — Plan-Execute-Verify elevated to load-bearing first-class citizen.
-
-The §Teach PEV subsection from v1.1.x is now subordinate to a new
-top-band `## §Plan-Execute-Verify` H2 in SKILL.md (visible from
-cold-start triage, not buried in §Teach). This makes PEV a first-class
-citizen of the skill's harness — the loop every mode invocation must
-close, not just §Teach landings.
-
-### Added — top-band `## §Plan-Execute-Verify` H2
-
-The new §PEV section names the **Plan → Execute → Verify** loop
-explicitly, with a per-mode verify-target table listing the
-**real-product** verify-target for each mode. For this skill:
-`curl -sf https://<host>.exe.xyz/` returns 200 with the new build hash + `systemctl --user status <service>` is active + audit re-run shows 0 findings.
-
-The section makes 4 things explicit:
-
-1. **Plan** = name the verify-target up front. If you can't name it,
-   you don't have a plan, you have a vibe.
-2. **Execute** = run the procedure. Capture artifacts the verify step
-   will read.
-3. **Verify** = run the result against the real product or substrate
-   — NOT against the skill's own self-checks.
-4. **§SelfAudit ≠ PEV** — §SelfAudit checks the skill's structural
-   invariants. Both disciplines are required; neither substitutes
-   for the other.
-
-### Changed — §Teach now cross-references §PEV
-
-§Teach landings inherit the PEV loop via cross-reference back to the
-top-band §PEV H2. The §Teach PEV subsection from v1.1.x is retained
-for §Teach-specific guidance but no longer carries the load-bearing
-discipline-statement.
-
-### Mechanized — `scripts/skills/check-pev.mjs`
-
-A new 5-point gate enforces the §PEV binding across all senior skills:
-
-- **P1**: top-band `## §Plan-Execute-Verify` H2 present + ≥800 chars
-- **P2**: per-mode verify-target table inside §PEV
-- **P3**: §Teach cross-references §PEV
-- **P4**: cold-start band mentions Plan-Execute-Verify
-- **P5**: skill.json description claims a verify capability
-
-Wired into `npm run check:skills` chain. This skill passes `--strict`.
-
-### Ecosystem-level changes
-
-- `VISION-extensibility.md` §Premise rewritten to lead with PEV as
-  the spine; new H2 `## §Plan-Execute-Verify` (the loop everything
-  else serves) added with the 5-point PEV-binding check + anti-patterns.
-- `SKILLS-best-practices.md` §0 promoted from "two principles (A+B)"
-  to PEV-only ("the principle everything else serves"); citation-
-  layer demoted to §0.5.
-- `AGENTS.md` Hard Rule 14 added: "Plan → Execute → Verify is the
-  load-bearing loop on every senior-skill invocation".
-- `INDEX.md` Tier 1 paragraph rewritten to lead with PEV as the
-  binding centerpiece.
-- `BORIS-feedback.md` §B1 (previously flagged as "the most-cited
-  Boris principle and our biggest gap") marked **RESOLVED**.
-
-## [1.1.0] stable — 2026-05-22
-
-**MINOR** — §Teach H2 section inline in SKILL.md (closes anti-pattern 4 —
-capability-menu lie) + WHAT+WHEN+NEG description.
-
-### Added — `## §Teach` H2 section in SKILL.md
-
-The v1.0.x §Status section claimed "✅ §Teach section — see
-references/teach-protocol.md" but no `## §Teach` H2 actually existed in
-SKILL.md. This was a **capability-menu lie** per VISION-extensibility.md
-§Where this vision could go wrong (anti-pattern 4 — capability menu
-points to a section that doesn't exist).
-
-The new §Teach H2 (~5,200 chars) follows the canonical template from
-`adia-ui-release`/`adia-ui-kit`:
-
-- Ecosystem-context callout (N=5 instantiation, cross-reference to
-  `VISION-extensibility.md`)
-- 30-second procedure with skill-specific decision-tree branches
-  (substrate vs. audit-patterns vs. doc-types vs. recipes vs.
-  deploy-playbooks vs. audit-cadence vs. guidance vs. standards vs.
-  INLINE in SKILL.md vs. journal)
-- 5-step landing procedure
-- 7 anti-patterns (universal)
-- **Plan-Execute-Verify section** (per `BORIS-feedback.md` §B1 — the
-  biggest gap identified in the senior-engineering review)
-- Cross-references to `references/teach-protocol.md` + sibling skills
-
-### Changed — Description rewrites for routing accuracy
-
-Per `SKILLS-best-practices.md` §13.7 + `BORIS-feedback.md` §B9:
-
-- `skill.json` description condensed to WHAT+WHEN+NEG (930 chars)
-- SKILL.md frontmatter description gained "Does NOT trigger for:"
-  clause authored as anti-vocabulary
-- §Status checklist item 3 corrected ("✅ §Teach section" → "✅
-  `## §Teach` H2 in SKILL.md + references/teach-protocol.md for the
-  full procedure")
-
-### Routing eval impact
-
-adia-ui-ops F1 held at 86%; overall accuracy 73.3% → 78.3% (+5pp).
-
-## [1.0.1] stable — 2026-05-22 (Phase 5b — 2 absorbed redirect stubs deleted)
-
-### Removed — 2 redirect stubs
-
-After the Phase 5a citation sweep + routing-parity backfill landed
-(commit `83735afe6`), the cleanup-readiness gate reported routing
-parity GREEN for all 2 absorbed redirects. Phase 5b deleted the stubs:
-
-- `.agents/skills/exe-dev-ops/`  (3.1K SKILL.md + skill.json; v3.0.0 redirect)
-- `.agents/skills/ops-repo/`     (4.0K SKILL.md + skill.json + CHANGELOG; v3.0.0 redirect)
-
-**Trigger phrases preserved.** Before deletion, routing parity verified
-all 27 redirect trigger phrases (13 + 14) are still present in this
-skill's `trigger:` cluster.
-
-**Citation sweep audit:** 27 routing-harmful citations across 8 files
-were rewritten in Phase 5a before this deletion landed. The remaining
-~138 grep hits for `ops-repo` are predominantly concept-as-brand
-references (`.brain/config.toml` sections, postmortem 'owners'
-attribution, `ops-repo.dev` schema URLs, `/ops-repo` slash-command) —
-they refer to the methodology this skill embodies and rewriting them
-would destroy the concept-as-brand audit trail. Per the Hermes skill
-calibration, these are NOT routing-harmful.
-
-**§SelfAudit Axis 9** now reports `absorbed-clean-deleted` for both
-redirects (verified via `audit-ops-roster.mjs`).
-
-### Pairs with
-
-- `~/.hermes/skills/software-development/skill-redirect-citation-sweep/SKILL.md` (Steps 7-12)
-- Phase 5a sweep commit `83735afe6`
-
-## [1.0.0] stable — 2026-05-22 (rollup ship; instantiation N=5 of the extensibility pattern)
-
-### Added — initial rollup release
-
-The 5th rollup skill (paired with `adia-ui-kit`, `adia-ui-release`,
-`adia-ui-authoring`, `adia-ui-a2ui`). Authored as Phase 4 of the
-skills-rollup-roadmap-2026-05-22.
-
-**Absorbs 2 standalone skills:**
-
-- `exe-dev-ops` (166 lines) — exe.dev VM service operations: provision,
-  deploy, diagnose, rotate secrets. Platform contract for the shared
-  Linux VMs at `<host>.exe.xyz`.
-- `ops-repo` (204 lines SKILL.md + ~7,700 lines across 45 reference
-  files) — repo memory layer audit + curation. AGENTS.md-as-canonical
-  with CLAUDE.md-as-pointer harness. 16 audit patterns, 6 doc-type
-  templates, 3 recipes, 3 guidance docs. Earlier absorbed
-  `github-release`, `lockstep-release`, `stale-audit`.
-
-**Reference structure (load-on-demand):**
-
-| Reference | Source | Mode |
-|-----------|--------|------|
-| `deploy-playbooks.md` | from exe-dev-ops (entire SKILL.md content) | modes 1-4 |
-| `audit-cadence.md` | from ops-repo §Invocation + §The five promises + §Verification + §Audit categories | mode 5 |
-| `audit-patterns/` (16 files) | preserved verbatim from ops-repo/references/audit-patterns/ | mode 6 |
-| `doc-types/` (6 files) | preserved verbatim from ops-repo/references/doc-types/ | mode 7 |
-| `recipes/` (3 files) | preserved verbatim from ops-repo/references/recipes/ | mode 8 |
-| `genres/` (1 file) | preserved verbatim from ops-repo/references/genres/ | (cross-cut) |
-| `guidance/` (3 files) | preserved verbatim from ops-repo/references/guidance/ | (cross-cut) |
-| `standards/` (preserved) | preserved verbatim from ops-repo/references/standards/ | (cross-cut) |
-| `teach-protocol.md` | NEW (instantiation N=5) — mirrors canonical adia-ui-kit/references/teach-protocol.md universal sections | mode 9 |
-
-**Absorption strategy: preserve-verbatim**
-
-Unlike Phase 3 (adia-ui-a2ui) which decomposed source SKILL.md sections
-into new reference files, this absorption **preserves ops-repo's existing
-references/ subdirectory structure verbatim**. ops-repo's catalogue
-shape was already well-organized (audit-patterns/, doc-types/, recipes/,
-genres/, guidance/, standards/); fragmenting it would lose hard-won
-organization. Only the SKILL.md content was decomposed:
-
-- ops-repo §Invocation + §The five promises + §Verification → `audit-cadence.md`
-- ops-repo §Audit categories + §Composition + §Invariants → `audit-cadence.md` (continued)
-- exe-dev-ops (entire SKILL.md) → `deploy-playbooks.md`
-
-The 45 reference files under audit-patterns/, doc-types/, recipes/,
-genres/, guidance/, standards/ moved with full path-preservation
-(`ops-repo/references/audit-patterns/stale-content.md` → 
-`adia-ui-ops/references/audit-patterns/stale-content.md`).
-
-**§Teach extensibility — N=5 from day 1**
-
-Per the Phase 3 lesson (ship §Teach with all 5 harness-integration
-points from initial commit, never as a follow-up), this skill includes:
-
-1. ✅ Frontmatter `trigger:` cluster with ~55 phrases including universal
-   teach triggers
-2. ✅ Capability menu item — mode 9 "📚 Teach the skill new knowledge"
-3. ✅ §Teach posture body in `references/teach-protocol.md` (~9K, mirrors
-   the canonical adia-ui-kit/references/teach-protocol.md)
-4. ✅ Vision cross-reference in SKILL.md intro ("Ecosystem context")
-5. ✅ Reference manifest row for teach-protocol.md in §FileMap
-
-**7-branch decision tree** for §Teach landings (per teach-protocol.md):
-
-| Branch | When | Lands at |
-|--------|------|----------|
-| A | New audit pattern | `audit-patterns/<name>.md` |
-| B | New doc-type template | `doc-types/<type>.md` |
-| C | New recipe / workflow | `recipes/<name>.md` |
-| D | New deploy playbook step | `deploy-playbooks.md` |
-| E | New invariant / posture | Inline SKILL.md §Posture / §FirstPrinciples |
-| F | New guidance / cross-cut | `guidance/<name>.md` |
-| G (NEGATIVE) | One-off audit-arc story | `docs/journal/` |
-
-**Skill-owned tooling:**
-
-- `scripts/audit-ops-roster.mjs` — 4-axis self-audit (structural integrity,
-  reference graph, capability menu coverage, ops-roster currency)
-
-### Removed — 2 standalone skill stubs converted to redirects
-
-Same cut converts the 2 absorbed standalones into thin redirect stubs
-(`status: redirect`, v3.0.0) pointing at this skill. Phase 5 of the
-roadmap will eventually delete these stubs after a citation sweep.
-
-### Pairs with
-
-- `.brain/notes/2026-05-22-skills-rollup-roadmap.md` Phase 4 (this commit)
-- `.agents/skills/VISION-extensibility.md` §HarnessIntegration (the binding gate)
-- `.agents/skills/SKILLS-best-practices.md` §1.0 (senior-skill classification)
-- `.agents/skills/adia-ui-kit/references/teach-protocol.md` (canonical N=1 template)
-- `.agents/skills/adia-ui-release/CHANGELOG.md` v1.1.0 (N=2 instantiation)
-- `.agents/skills/adia-ui-authoring/CHANGELOG.md` v1.1.0 (N=3 instantiation)
-- `.agents/skills/adia-ui-a2ui/CHANGELOG.md` v1.0.0 (N=4 instantiation)