open/ms-ai-architect
1
0
Fork 0
Code Issues Pull requests Releases Activity
ms-ai-architect/docs/kb-update-apply-brief.md
Kjell Tore Guttormsen 1ae5655156 docs(ms-ai-architect): run-brief for utsatt /architect:kb-update apply 
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
2026-06-18 21:18:18 +02:00

3.4 KiB
Raw Blame History

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.