diff --git a/CLAUDE.md b/CLAUDE.md index f736c18..a0b7da0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -96,178 +96,6 @@ Agenter leser navngitte kjernefiler, ikke hele kataloger: Se `references/architecture/recommended-mcp-servers.md` for detaljer. -## Utvikling - -### Legge til ny kunnskapsbase -1. Opprett `.md`-fil i riktig undermappe under den relevante skillens `references/`-mappe (f.eks. `skills/ms-ai-engineering/references/`) -2. Følg format fra eksisterende filer (header, dato, seksjoner, "For Cosmo"-seksjon) -3. Oppdater relevant SKILL.md med referanse - -### Legge til ny kommando -1. Opprett `commands/navn.md` med frontmatter (`description`, `argument-hint`) -2. Følg mønster fra eksisterende kommandoer -3. Oppdater `commands/help.md` med ny kommando -4. Oppdater denne CLAUDE.md - -### Legge til ny agent -1. Opprett `agents/navn-agent.md` med frontmatter (`name`, `description`, `model`, `color`, `tools`) -2. Inkluder tydelig "triggers on" i description -3. Oppdater denne CLAUDE.md - -### Testing - -#### Statisk validering -```bash -# Kjør plugin-validering (frontmatter, encoding, KB-referanser) -bash tests/validate-plugin.sh -``` - -#### KB-ferskhet (sitemap-basert, manuell drift) - -**Apply-fasen kjøres via slash-kommandoen** (krever aktiv Claude Code-sesjon, holder oss innenfor Anthropic Consumer Terms § 3): - -```text -/architect:kb-update # default: critical + high -/architect:kb-update --priorities critical # bare critical -/architect:kb-update --skip-discover # hopp over new-URL discovery -/architect:kb-update --dry-run # rapport uten apply -``` - -**Endringsrapport-fasen kan kjøres som rent Node-script (ingen LLM-kostnad):** - -```bash -# Poll sitemaps → endringsrapport (ingen filendringer) -node scripts/kb-update/run-weekly-update.mjs --force - -# Med discovery av nye relevante sider -node scripts/kb-update/run-weekly-update.mjs --force --discover - -# Vis rapport på nytt etter polling -node scripts/kb-update/report-changes.mjs - -# Bygg/oppdater URL-registry fra referansefiler -node scripts/kb-update/build-registry.mjs [--merge] -``` - -Systemet sammenligner Microsoft Learn sitemap-`` med filenes `Last updated:` header, og genererer en prioritert endringsrapport (critical/high/medium/low). - -**Match rate:** ~69% av 1342 URLer matche mot sitemaps. ~31% (mest `azure/ai-foundry/openai/`-stier) finnes ikke i sitemaps pga. Microsofts URL-restrukturering. - -**Schedulering:** Pluginen schedulerer ingenting. Bruker som vil ha periodisk varsling kan sette opp egen cron / launchd / systemd / GitHub Actions som kjører `node scripts/kb-update/run-weekly-update.mjs --force --discover` (rapport-fasen, ikke apply). Apply-fasen er bevisst manuell — den krever LLM-resonnering på diff og kjører fra en åpen Claude Code-sesjon. - -Legacy (deprecated): -```bash -bash scripts/kb-staleness-check.sh # mtime-basert, upålitelig etter git clone -``` - -#### E2E-regresjonstester -```bash -# Kjør alle E2E-suiter -bash tests/run-e2e.sh - -# Kjør enkeltsuiter -bash tests/run-e2e.sh --security -bash tests/run-e2e.sh --cost -bash tests/run-e2e.sh --summary -bash tests/run-e2e.sh --ai-act -``` - -Fixture-basert validering av agent-output (sikkerhet, kostnad, sammendrag). Tester struktur, encoding, og domene-spesifikke krav uten å invokere Claude. - -#### Manuell test -```bash -# Test at plugin registreres -cd -claude --plugin ./plugins/ms-ai-architect - -# Kjør hovedcommand -/architect - -# Vis alle kommandoer -/architect:help -``` - -## Playground (v3 / v1.15.0) - -Interaktiv decision-builder + rapport-viewer for Microsoft AI-beslutninger. Erstatter v2 5-stegs-pipelinen med en multi-surface-app som persisterer state og visualiserer importerte rapporter inline. Spec: v3-arkitektur dokumentert under `.claude/projects/2026-05-03-playground-v3-architecture/`. v1.10.0-utvidelser dokumentert under `.claude/projects/2026-05-03-ms-ai-architect-v1-10-playground/`. v1.11.0 leverer design-system 100%-adoption. v1.13.0/.1 patchet 10+ symptomatiske visuelle bugs. v1.14.0 leverer root-cause refaktor over 6 sesjoner (DS-konvensjon-adopsjon på 14 renderere, lokal CSS halvert). - -**v1.15.0 (sesjon 5 av ~8 i v2-prosjektet):** Project-surface byttet fra v2 `renderProjectSurface` (screen-tabs + category-tabs + per-command paste-cards) til v3 `renderProjectView` (sidebar med 17 artifacts + main-area + import-modal overlay). `renderActive()` ruter `project`-surface til `renderProjectSurfaceV3()` som wrapper renderProjectView + topbar + app-shell. V2-surface helt fjernet: `renderProjectSurface` (152 linjer), `renderCommandSubCard` (87 linjer), `rehydratePasteImports` (15 linjer), `currentProjectScreen`, `ACTIONS['project-screen']`, 5 v2-CSS-klasser. Zombie-handlers beholdt for test-back-compat: `currentProjectTab`, `ACTIONS['project-tab']`, `ACTIONS['parse']`, `handlePasteImport`, `window.__handlePasteImport`. 2 fingerprint-gap lukket: requirements.headers + license.headers. `migrateDataVersion` utvidet med `parserFor` → demo-state (kun `raw_markdown`) auto-parses til `project.artifacts[cid]`. Ship-QA-bugfixes: `components-tier4-project-view.css` lagt til i ``-kjeden (manglet → modal-overlay og two-column layout virket ikke); `renderImportModal` setter `data-open="true"` (DS-kontrakt). - -- **Fil:** `playground/ms-ai-architect-playground.html` (~3870+ linjer, single-file v3-arkitektur) -- **4 surfaces:** Onboarding (18 felles felt — 4 strukturerte / 14 fritekst etter v1.10.0) → Home (prosjekt-liste + 3 entry-tracks) → Catalog (25 commands gruppert i 5 expansion-grupper med søk) → **Project v3** (sidebar med 17 artifacts gruppert i 4 kategorier + søk + main-area med per-artifact view eller overview med top-risks/next-actions + import-modal som DS-overlay) -- **Persistens:** IndexedDB-primær med localStorage-fallback. Schema-versjonert (`STATE_KEY = 'ms-ai-architect-state-v1'`) med eager `MIGRATIONS`-pipeline. v1.10.0 introduserer `dataVersion v1→v2`-migrasjon (idempotent) som backfill-er `verdict`+`keyStats`. -- **17 rapport-renderers (felles grunnskjelett):** Alle wrapper output via `renderPageShell()` med eyebrow + h1 + valgfri verdict-pill + valgfri key-stats-grid + arketype-spesifikk body. Parser → struktur → HTML rutet via kanonisk archetype-routing-tabell. -- **Foundation-helpers:** `renderPageShell`, `renderVerdictPill`, `renderKeyStatsGrid`, `inferVerdict`, `inferKeyStats`, `KEY_STATS_CONFIG`. -- **Tier 3-adopsjon:** kanban (conformity, review), mat-ladder (migrate, poc), screen-tabs (utredning, project surface), scenario-card-grid (license, compare), residual-pair (dpia, ros), top-risks (ros), recommendation-card (security, ros), suppressed-panel (review), critique-card (adr), read-more (utredning, summary), traffic-light (poc). -- **Theme:** Mørk default + lys theme-toggle med Aksel-tokens i begge moduser (lagt til i v1.10.0). Persistert i `localStorage('ms-ai-architect-theme')`. Theme-bootstrap-script i `` unngår FOUC. -- **Eksport/import:** JSON Decision Record-envelope (Blob + FileReader), schema-versjon-bevisst på import. - -### Validering (v1.15.0-tall) - -| Test | Kommando | Dekning | -|------|----------|---------| -| Statisk struktur | `bash tests/test-playground-v3.sh` | 219 PASS, 2 WARN (pre-eks.) — vendored CSS, surfaces, 25 commands, 14 parsere, 17 renderers via PROJECT_VIEW_CONFIG.renderers-routing, action-handlers | -| Parser-fixtures | `bash tests/test-playground-parsers.sh` | 70 PASS — 17 fixtures × parser-routing | -| Migrasjon | `bash tests/test-playground-migrations.sh` | 16 PASS — v1→v2 + v2→v3 idempotent migrasjon | -| Fingerprints | `bash tests/test-playground-fingerprints.sh` | 32 PASS — 17-fixture true-positive + 4 anti-match + API-sanity | -| Project-view | `bash tests/test-playground-projectview.sh` | 30 PASS — 4 view-states + nav-søk + null-guard | -| ACTIONS | `bash tests/test-playground-actions.sh` | 19 PASS — 6 pure-state-handlers + projectViewUiState | -| Kombinert (E2E) | `bash tests/run-e2e.sh --playground` | 386 PASS, 0 FAIL, 2 WARN | -| Plugin-validering | `bash tests/validate-plugin.sh` | 219 PASS | -| Manuell A11Y QA | Se `playground/MANUAL-CHECKLIST.md` | 10 seksjoner inkl. axe-core-kjøring per surface | -| A11Y-rapport | `playground/A11Y-RAPPORT.md` | Statisk vurdering klar — browser-axe-kjøring pending | - -### Demo system (v1.11.0 → v1.15.0) - -`scripts/build-demo-state.mjs` leser alle 17 fixture-filer fra `playground/test-fixtures/` og injiserer dem som en `