Kjell Tore Guttormsen
1ae5655156
Eneste gjenstående post etter v1.16.0 (audit #5–#9 komplett). Fokusert run-plan som komplementerer commands/kb-update.md med beslutninger/kontekst spesifikt for denne kjøringen: hvorfor fersk sesjon (kjører i hovedkontekst, ~80 fetches uten subagent-isolasjon), anbefalt kjøring, beslutningspunkter, push-vindu-timing, post-run telling-resync, og testbar verifisering. Pekt til fra STATE.md (gitignored). Per kontinuitets-regel: planer/briefer bor i docs/ ved siden av staten. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01REiKFhP4w6xGXXqWKpPCJJ
40 lines
3.4 KiB
Markdown
40 lines
3.4 KiB
Markdown
# Brief — `/architect:kb-update` apply-kjøring
|
||
|
||
_Run-plan for den ENESTE gjenstående posten etter v1.16.0 (audit #5–#9 komplett). Autoritativ spec: `commands/kb-update.md` — denne briefen dekker kun beslutninger og kontekst spesifikt for DENNE kjøringen. Pekt til fra STATE.md._
|
||
|
||
## Status
|
||
**UTSATT — venter på operatør-go. Ikke startet.** Change-detection-fasen er klar; kun apply (fetch + edit + commit) gjenstår.
|
||
|
||
## Hvorfor egen, fersk sesjon (besluttet 2026-06-18)
|
||
`/architect:kb-update` kjører **alt i hovedkonteksten — ingen subagent-isolasjon** (`microsoft_docs_fetch` + `Edit` i main loop, steg 4b–4d i kommandoen). Default `critical,high` ≈ **53 filer** (9 critical + 44 high) × ~1,5 kilder = **~80 fetches**, hver en full Learn-markdown-side (flere tusen tokens) som akkumuleres i konteksten. Kommandoen bruker Opus fordi diff-resonneringen krever nyanse → best kvalitet med fullt, rent budsjett. Start derfor i fersk sesjon; SessionStart-hooken surfacer denne posten umiddelbart via STATE.md.
|
||
|
||
## Anbefalt kjøring
|
||
1. Fersk sesjon i `ms-ai-architect/`.
|
||
2. `claude mcp list` → bekreft at `microsoft-learn` MCP er aktiv (kommandoen krever den).
|
||
3. `/architect:kb-update --dry-run` FØRST → se eksakt fil-/fetch-tall per prioritet før du forplikter.
|
||
4. Vurder beslutningspunktene under, kjør så uten `--dry-run`.
|
||
|
||
## Beslutningspunkter (operatør avgjør ved kjøring)
|
||
- **Prioriteter:** default `critical,high` (~53 filer). Utvid til `--priorities critical,high,medium` kun før en stor utredning/ADR (tyngre, flere fetches).
|
||
- **Commit-modus:** `--single-commit` anbefales for ren historikk (én `chore: refresh KB — N files`) framfor ~53 per-fil-commits.
|
||
- **Discovery:** default `--discover` på. `--skip-discover` = raskere, ingen nye URLer oppdages.
|
||
|
||
## Push-vindu + timing
|
||
Apply tar reelt 15–40 min (fetch ~3–7 min + LLM-diff per fil). Hverdager stenger push-vinduet 23:00 → starter du sent, parkér committen til neste vindu (helg åpent). `TZ=Europe/Oslo date '+%u %H:%M'` før push.
|
||
|
||
## Etter kjøring — obligatoriske oppgaver
|
||
- **Telling-resync:** apply på EKSISTERENDE filer endrer IKKE 389. MEN hvis discovery fører til nye KB-filer, må 389 re-synkes på ALLE steder: README badge (L11) + prosa (L207, L605) + KB-tabell (L214) + per-skill-seksjon (L229); CLAUDE.md skill-tabell (L75); SKILL.md subdir-tabell. Fasit: `find skills/*/references -name '*.md' -type f | wc -l`.
|
||
- **Wiring:** nye filer MÅ wires i respektiv SKILL.md (ellers nye orphan-warnings over baseline 262).
|
||
- **STATE.md:** oppdater ved sesjonsslutt (fjern kb-update fra gjenstående hvis fullført).
|
||
|
||
## Fallgruver (fra `commands/kb-update.md`)
|
||
- **Sitemap-coverage ~69 %:** ~31 % (mest `azure/ai-foundry/openai/`) finnes ikke pga. URL-restrukturering hos Microsoft → rapporteres «always stale», vurderes manuelt.
|
||
- **MCP-tilgjengelighet:** krever aktiv `microsoft-learn`-server (sjekk steg 2).
|
||
- **Modellvalg:** Opus for diff-nyanse; ren «refresh dates» kan kjøres på Sonnet via config-override.
|
||
|
||
## Verifisering (testbare kriterier)
|
||
- `bash tests/validate-plugin.sh` → 239 PASS / 0 FAIL.
|
||
- `bash tests/test-kb-integrity.sh` → 115/115; orphan-warnings IKKE økt utover 262 (med mindre nye filer bevisst lagt til + wiret).
|
||
- Hver oppdatert fil har `Last updated:`-header = kjøredato.
|
||
- `git log --oneline` viser refresh-commit(er) med `[skip-docs]`-suffiks.
|
||
- Hvis discovery kjørte: README/CLAUDE.md/SKILL.md-tellinger matcher faktisk filtelling.
|