open/config-audit
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions
config-audit/STATE.md
Kjell Tore Guttormsen 55f83a3c99 feat(knowledge): best-practices register foundation — v5.7 Fase 1 Chunk 1 
Add knowledge/best-practices.json: a machine-readable, provenance-stamped, schema-validated best-practices register — the source of truth for the upcoming v5.7 optimization lens (CA-OPT). 13 seed entries migrated from the v5.5 V-rows (loading-model + compaction facts) and the Anthropic 'Steering Claude Code' blog (mechanism-fit rules); each entry carries source.url + verified date + confidence. Only confirmed claims are user-facing (Verifiseringsplikt).

scanners/lib/best-practices-register.mjs: zero-dependency loader + validator (loadRegister/validateRegister/getEntry, native JSON.parse — not YAML, since the repo is zero-dep and yaml-parser.mjs can't parse arrays-of-objects). tests/lib/best-practices-register.test.mjs: 22 tests (schema, provenance integrity, negative cases, lookup).

Byte-stable: no scanner consumes the register yet (Chunk 2), so all scanner output is unchanged. Suite 1023->1045, self-audit A/A, readmeCheck passed. Full design: docs/v5.7-optimization-lens-plan.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 22:37:47 +02:00

3.8 KiB
Raw Blame History

STATE — config-audit

Current state-of-play for DENNE pluginen. Auto-injisert ved sesjonsstart. Overskrives (ikke append) ved sesjonsslutt. Historikk → git (STATE.md er tracked). Stier relative til plugin-mappa.

Aktiv kontekst (v5.7 Fase 1 Chunk 1 DONE — neste: Chunk 2 = optimerings-linsen CA-OPT)

v5.6.0 released. v5.7 Fase 1 Chunk 1 (register-fundament) ferdig & verifisert denne økten. Suite 1045, scanner 14, self-audit A/A (plugin 100 / config 93), readmeCheck passed.

Visjons-diskusjonen (2026-06-20) ga GO-ready plan → docs/v5.7-optimization-lens-plan.md (les FØR videre arbeid). Skifte: korrekt? → optimal? («F1-tuning»). 4 byggeklosser, 2 faser. Fase 1 = blokk 1+2; Fase 2 = blokk 3+4 (utsatt, eget GO).

Låste beslutninger (2026-06-20)

  • Rekkefølge: Fase 1 (linse + kunnskapsbase) FØRST, så Fase 2 (kampanje + backlog).
  • Kunnskaps-format: strukturert JSON-register (zero-dep avgjorde YAML vs JSON; yaml-parser.mjs kan ikke arrays-of-objects); markdown som speil.
  • Linse-motor: ny familie (CA-OPT) + hybrid motor (determ. pre-filter → opus-analyzer), presisjons-gated.

Chunking (ett GO'd-sesjon hver)

  1. Chunk 1 — Register-fundament: ✅ DONE. knowledge/best-practices.json (13 entries: V-rader + blogg-regler, kildefestet) + scanners/lib/best-practices-register.mjs (loadRegister/validateRegister/getEntry) + tests/lib/best-practices-register.test.mjs (22 tester). Byte-stabil (ingen scanner konsumerer det ennå).
  2. Chunk 2 — Linsen (CA-OPT) — NESTE, KREVER GO: determ. pre-filter + opus-analyzer-agent som leser registeret + dømmer mekanisme-fit + humanizer/scoring-wiring + fixtures (positiv + negativ, null false-positive) + byte-stab strip (følg CA-OST-presedens). lensCheck-feltene i seedet peker allerede på detektorene som skal bygges.
  3. Chunk 3 — knowledge-refresh: semi-auto poller (--dry-run, stale/candidate, human-godkjente skriv).

Åpne tråder / neste steg (prioritert)

  1. Chunk 2 (CA-OPT-linsen) — KREVER GO. Les plan-doc-en + registeret først.
  2. Fase 2 (kampanje + backlog) — utsatt, eget GO etter linse-validering på ett repo.
  3. Åpne design-detaljer (i planen): endelig ID-prefix (CA-OPT?), refresh-kilder/kadens, /repo-init-synergi (linsen som kvalitetsmåler).
  4. llm-security KRITISK (annet repo) + 3 aktive plugins + STATE-sveip — uendret. Egne GO.

Gotchas (UFRAVIKELIG)

  • CLAUDE.md-lengde drar config-grade. Lange architecture-tillegg i pluginens egen CLAUDE.md tipper CML «getting long»-gradienten (A93→B89 sett denne økten). Hold tillegg lean; full detalj → docs/. Mål alltid self-audit mot baseline FØR commit.
  • Scanner-/familie-tillegg = strip, IKKE re-seed (POST-B2). Bevar frozen v5.0.0 via strip-helpere; re-seed KUN SC-5. CA-OPT (Chunk 2) følger CA-OST-presedensen (bumper scanners_ok → strip).
  • Release-cut = 3 filer + annotert tag + catalog. plugin.json + README (badge + 1 version-history-rad) + CHANGELOG; så git tag -a; så ../catalog ref-bump. tests-badge = ℹ tests N (countTestCases), readmeCheck.passed:true. Nå: 1045, scanner 14. Knowledge-badge teller kun .md (JSON-registeret påvirker den ikke).
  • Persistens (verifisert): sesjoner i ~/.claude/config-audit/sessions/ ligger UTENFOR plugin-mappa → overlever reinstall/oppgradering.
  • Push-vindu: hverdag 20–23, helg fritt. docs-gate: feat: krever ≥3 ikke-ws-linjer i README+CLAUDE.md.

Scope-gjerde

Chunk 1 komplett, verifisert, committet. Chunk 2 (CA-OPT) krever eget GO. Ingen annen kode-oppgave åpen.

Kontinuitet

Tre lag: STATE.md (tracked) + auto-memory (config-audit-vision — låste beslutninger) + CLAUDE.md. Plan-detalj → docs/v5.7-optimization-lens-plan.md. Oppdater DENNE som siste handling.