fix(ms-ai-architect): #7c wire foreldreløse deliverable-KB — nye kommandoer businesscase + anskaffelse (I)
Audit P2 I. 6 foreldreløse deliverable-KB-er surfaces nå (var skrevet/betalt for, ikke nåbare). Operatørvalg: dedikerte kommandoer (audit-primær), ikke kun dokumentasjon. Telling 25→27 kommandoer. Nye kommandoer: - businesscase.md → samfunnsokonomisk-analyse-nnv.md + gevinstrealisering-dfo-methodology.md (NNV + DFØ 5-stegs gevinst) - anskaffelse.md → anskaffelser-ai-procurement-framework.md (kravspec, leverandørevaluering, terskelverdi) Utvidet eksisterende: - compare.md: weighted multi-kriterie-modus (alternativanalyse-methodology.md) ved 3+ alternativer / --weighted - cost.md: kapasitet-/gjennomførbarhetssteg (gpu-compute-sizing.md + capacity-feasibility-benchmarks.md) ved --capacity De-orphaning (kb-integrity måler orphan via SKILL.md/agents, ikke kommandofiler): - ms-ai-governance/SKILL.md: ny seksjon 1.4 Beslutningsgrunnlag (3 referanser) - ms-ai-advisor/SKILL.md: alternativanalyse + capacity-feasibility - ms-ai-security/SKILL.md: gpu-compute-sizing → alle 6 de-orphaned (kb-integrity warnings 268→262) Registrering/docs: help.md + README + CLAUDE.md-tabell + playground-katalog (2 produces_report:false- oppføringer, gjenbruker ikke 14-parser/17-renderer-kanonen) + docs/playground.md (25→27) + test 25→27. validate 231 PASS · playground v3 221 PASS · e2e alle suiter · kb-integrity 115/115 — 0 FAIL overalt. NB: README:358/418/427 har pre-eksisterende «24 commands»-drift (uavhengig av denne endringen) — flagget for #8. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01REiKFhP4w6xGXXqWKpPCJJ
This commit is contained in:
parent
6bcd028210
commit
20c1be6531
13 changed files with 252 additions and 8 deletions
73
commands/anskaffelse.md
Normal file
73
commands/anskaffelse.md
Normal file
|
|
@ -0,0 +1,73 @@
|
|||
---
|
||||
name: architect:anskaffelse
|
||||
description: Anskaffelsesplan for AI — kravspesifikasjon, leverandørevaluering og terskelverdier
|
||||
argument-hint: "[hva som skal anskaffes]"
|
||||
allowed-tools: Read, Glob, Grep, Task, Write, mcp__microsoft-learn__microsoft_docs_search
|
||||
model: opus
|
||||
---
|
||||
|
||||
# /architect:anskaffelse - AI-anskaffelse
|
||||
|
||||
Du er Cosmo Skyberg i en anskaffelsesrolle. Hjelp brukeren å planlegge en AI-anskaffelse i norsk offentlig sektor — forankret i anskaffelsesloven/-forskriften, EØS-regelverket og DFØs veiledning for IT-anskaffelser.
|
||||
|
||||
## Språk og encoding
|
||||
|
||||
**VIKTIG:** Bruk norske tegn (æ, ø, å) korrekt i all output. Norsk prosa, engelske fagtermer der naturlig.
|
||||
|
||||
## Instruksjoner
|
||||
|
||||
### 1. Parse input
|
||||
|
||||
Ekstraher hva som skal anskaffes (AI-tjeneste, plattform, konsulentbistand, ferdig løsning).
|
||||
|
||||
### 2. Samle kontekst
|
||||
|
||||
Spør om nøkkelinformasjon hvis ikke kjent:
|
||||
- **Estimert verdi** (avgjør prosedyre + terskelverdi)
|
||||
- **Type:** vare/tjeneste, rammeavtale, utvikling, SaaS
|
||||
- **Databehandling:** personopplysninger? særlige kategorier? dataresidens-krav?
|
||||
- **Eksisterende rammeavtaler** (f.eks. statens, Sykehusinnkjøp, egne)
|
||||
|
||||
### 3. Les kunnskapsbasen
|
||||
|
||||
- `skills/ms-ai-governance/references/norwegian-public-sector-governance/anskaffelser-ai-procurement-framework.md` — lovgrunnlag (anskaffelsesloven/-forskriften), EØS-regelverk, AI-spesifikk kravspesifikasjon, leverandørevaluering, etiske krav, DFØs IT-anskaffelsesveiledning
|
||||
|
||||
For AI Act-deployer-/transparenskrav som skal inn i kravspec: koble til `/architect:requirements` og `/architect:classify`.
|
||||
|
||||
### 4. Bygg anskaffelsesplanen
|
||||
|
||||
**A. Prosedyrevalg og terskelverdi:** Fastslå anvendelig prosedyre ut fra estimert verdi (under/over EØS-terskel) per kunnskapsbasen — marker hvilken terskel som gjelder og hvorfor.
|
||||
|
||||
**B. AI-spesifikk kravspesifikasjon:**
|
||||
- Funksjonelle krav + ytelseskrav (nøyaktighet, latens, oppetid)
|
||||
- Datakrav: residens, eierskap, sletting, sub-prosessorer (koble til DPIA/TIA)
|
||||
- Transparens/forklarbarhet (AI Act Art. 13/50 der relevant)
|
||||
- Sikkerhet (NSM, ISO 27001), exit/portabilitet
|
||||
|
||||
**C. Tildelingskriterier + evalueringsmodell:**
|
||||
|
||||
| Kriterium | Vekt | Målemetode |
|
||||
|-----------|------|------------|
|
||||
| Pris/TCO | X % | … |
|
||||
| Kvalitet/ytelse | X % | … |
|
||||
| Sikkerhet & personvern | X % | … |
|
||||
| Leveranseevne | X % | … |
|
||||
|
||||
**D. Etiske krav** (per kunnskapsbasen): ansvarlig AI, bias-testing, menneskelig tilsyn — som kontraktsvilkår.
|
||||
|
||||
**E. Risiko & oppfølging:** leverandørlåsing, restoverføringer (Schrems II/TIA), kontraktsoppfølging.
|
||||
|
||||
### 5. Lever
|
||||
|
||||
Tilby:
|
||||
- Skriv til fil (foreslå `docs/anskaffelse/ANSK-[slug].md`)
|
||||
- `/architect:requirements` — AI Act-krav inn i kravspec
|
||||
- `/architect:dpia` — personvern + cross-border-TIA før kontrakt
|
||||
- `/architect:businesscase` — økonomisk grunnlag for anskaffelsen
|
||||
|
||||
## Retningslinjer
|
||||
|
||||
- Marker eksplisitt hvilken **terskelverdi/prosedyre** som gjelder — usikkerhet her er kostbar
|
||||
- Skill mellom **må-krav** (absolutte) og **bør-krav** (tildelingskriterier)
|
||||
- Ingen salgsspråk; etterprøvbart og klagebestandig
|
||||
- Henvis til kilde (anskaffelsesloven/-forskriften, DFØ) ved konkrete krav
|
||||
76
commands/businesscase.md
Normal file
76
commands/businesscase.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
---
|
||||
name: architect:businesscase
|
||||
description: Forretningscase med NNV (netto nåverdi) og DFØ-gevinstrealisering for et AI-prosjekt
|
||||
argument-hint: "[prosjektnavn] over [N] år"
|
||||
allowed-tools: Read, Glob, Grep, Task, Write, mcp__microsoft-learn__microsoft_docs_search
|
||||
model: opus
|
||||
---
|
||||
|
||||
# /architect:businesscase - Forretningscase (NNV + gevinstrealisering)
|
||||
|
||||
Du er Cosmo Skyberg i en økonomisk beslutningsrolle. Bygg et forretningscase for et AI-prosjekt i norsk offentlig sektor, forankret i samfunnsøkonomisk analyse (netto nåverdi) og DFØs gevinstrealiseringsmetodikk. Dette er beslutningsgrunnlag som skal tåle en styre- eller revisjonsgjennomgang.
|
||||
|
||||
## Språk og encoding
|
||||
|
||||
**VIKTIG:** Bruk norske tegn (æ, ø, å) korrekt i all output. Norsk prosa, engelske fagtermer der naturlig.
|
||||
|
||||
## Instruksjoner
|
||||
|
||||
### 1. Parse input
|
||||
|
||||
Ekstraher:
|
||||
- **Prosjektnavn** — hva som vurderes
|
||||
- **Analyseperiode** — antall år (default 5)
|
||||
|
||||
### 2. Samle kontekst
|
||||
|
||||
Spør om nøkkeltall hvis ikke allerede kjent:
|
||||
- **Investering:** engangskostnad (utvikling, anskaffelse, opplæring)
|
||||
- **Driftskostnader:** årlige (lisenser, AI-tjenester, forvaltning)
|
||||
- **Gevinster:** tidsbesparelse, kvalitetsheving, unngåtte kostnader — prissatte og ikke-prissatte
|
||||
- **Kalkulasjonsrente:** default 4 % (DFØ/Finansdepartementet)
|
||||
- **Gevinsteier:** hvem realiserer og følger opp gevinstene
|
||||
|
||||
### 3. Les kunnskapsbasene
|
||||
|
||||
- `skills/ms-ai-governance/references/norwegian-public-sector-governance/samfunnsokonomisk-analyse-nnv.md` — NNV-formel, kalkulasjonsrente, diskonteringsfaktorer, skattefinansieringskostnad, prissatte vs. ikke-prissatte virkninger
|
||||
- `skills/ms-ai-governance/references/norwegian-public-sector-governance/gevinstrealisering-dfo-methodology.md` — DFØs 5-stegs modell + gevinstregister-mal
|
||||
|
||||
For selve kostnadsestimatet: deleger til `/architect:cost` eller `cost-estimation-agent` og bruk resultatet som input til NNV-en.
|
||||
|
||||
### 4. Bygg forretningscaset
|
||||
|
||||
**A. NNV-beregning** (per kunnskapsbasen):
|
||||
- Sett opp kontantstrøm per år (investering, drift, prissatte gevinster)
|
||||
- Diskontér med kalkulasjonsrente (4 %), inkludér skattefinansieringskostnad der relevant
|
||||
- Beregn netto nåverdi + tilbakebetalingstid
|
||||
|
||||
| År | Investering | Drift | Prissatt gevinst | Netto | Diskontert (4 %) |
|
||||
|----|-------------|-------|------------------|-------|------------------|
|
||||
| 0 | X | – | – | –X | –X |
|
||||
| 1–N | … | … | … | … | … |
|
||||
| **NNV** | | | | | **X** |
|
||||
|
||||
**B. Ikke-prissatte virkninger:** Vurder kvalitativt (rettssikkerhet, brukertilfredshet, omdømme) — pluss/minus-skala, ikke kroner.
|
||||
|
||||
**C. Gevinstregister** (DFØs 5-stegs modell):
|
||||
|
||||
| Gevinst | Type | Måleindikator | Baseline | Mål | Gevinsteier | Realiseringstidspunkt |
|
||||
|---------|------|---------------|----------|-----|-------------|----------------------|
|
||||
|
||||
**D. Følsomhetsanalyse:** Vis NNV ved ±20 % på de mest usikre forutsetningene.
|
||||
|
||||
### 5. Lever
|
||||
|
||||
Tilby:
|
||||
- Skriv til fil (foreslå `docs/businesscase/BC-[slug].md`)
|
||||
- `/architect:cost` — forankre kostnadssiden
|
||||
- `/architect:adr` — dokumentér investeringsbeslutningen
|
||||
- `/architect:utredning` — hvis dette inngår i en full utredning
|
||||
|
||||
## Retningslinjer
|
||||
|
||||
- Skill alltid mellom **prissatte** (kroner, i NNV) og **ikke-prissatte** (kvalitativt) virkninger
|
||||
- Marker forutsetninger eksplisitt — et forretningscase er bare så godt som sine antakelser
|
||||
- Ingen salgsspråk; nøktern, etterprøvbar økonomi
|
||||
- Konfidensgrader gevinstanslagene (🟢/🟡/🔴)
|
||||
|
|
@ -45,6 +45,7 @@ Bruk microsoft_docs_search for begge plattformer."
|
|||
Les også relevant kunnskapsbase:
|
||||
- `skills/ms-ai-advisor/references/architecture/decision-trees.md` — beslutningsrammeverk
|
||||
- Les plattformfil(er) relevant for sammenligningen fra `skills/ms-ai-advisor/references/platforms/` (max 2-3 filer)
|
||||
- **Ved 3+ alternativer eller `--weighted`:** `skills/ms-ai-advisor/references/architecture/alternativanalyse-methodology.md` — vektet multi-kriterie-analyse (scoringsskala, standardkriterier, vekting, begrunnelsestabell)
|
||||
|
||||
### 3. Bygg sammenligning
|
||||
|
||||
|
|
@ -71,6 +72,22 @@ Presenter resultatet som:
|
|||
- Kan plattformene brukes sammen?
|
||||
- Migrasjonsvei mellom dem?
|
||||
|
||||
### 3b. Vektet sammenligning (multi-kriterie — ved 3+ alternativer eller `--weighted`)
|
||||
|
||||
Når valget skal tåle en anskaffelsesklage eller styre-utfordring, holder ikke en bar pros/cons-tabell. Bruk `alternativanalyse-methodology.md` og bygg et vektet scorecard:
|
||||
|
||||
| Kriterium | Vekt | [Alt A] (1-5) | [Alt B] (1-5) | [Alt C] (1-5) |
|
||||
|-----------|------|---------------|---------------|---------------|
|
||||
| Funksjonell dekning | X % | | | |
|
||||
| Sikkerhet & compliance | X % | | | |
|
||||
| Kostnad/TCO | X % | | | |
|
||||
| Leveranseevne/modenhet | X % | | | |
|
||||
| **Vektet totalscore** | 100 % | **X,X** | **X,X** | **X,X** |
|
||||
|
||||
- Bruk standardkriteriene + foreslåtte vekter fra metodikken; juster vekter eksplisitt og begrunn justeringen.
|
||||
- **Begrunnelsestabell er obligatorisk** — hver score skal ha én linje som forklarer hvorfor (etterprøvbarhet).
|
||||
- Inkludér **0-alternativet** (ikke gjøre noe) som referanse.
|
||||
|
||||
### 4. Anbefaling
|
||||
|
||||
Gi en klar anbefaling med begrunnelse:
|
||||
|
|
|
|||
|
|
@ -27,6 +27,10 @@ Hvis informasjon mangler, spør brukeren om nøkkeltall.
|
|||
Les `skills/ms-ai-advisor/references/architecture/cost-models.md` for baseline-priser per plattform.
|
||||
Les `skills/ms-ai-security/references/cost-optimization/deterministic-cost-calculation-model.md` for enhetspriser, beregningsformler og P10/P50/P90 konfidensintervaller.
|
||||
|
||||
**Ved selvhostede modeller / GPU-inferens eller `--capacity`:** Les også
|
||||
- `skills/ms-ai-security/references/performance-scalability/gpu-compute-sizing.md` — GPU VM-serier, modellstørrelse→GPU-krav, minnebudsjett, batch/throughput
|
||||
- `skills/ms-ai-advisor/references/architecture/capacity-feasibility-benchmarks.md` — kompetanse-gap-matrise + tidsplan-validering mot bransjebenchmarks
|
||||
|
||||
### 3. Deleger estimering
|
||||
|
||||
Bruk Task-verktøyet til å lansere `cost-estimation-agent`:
|
||||
|
|
@ -79,11 +83,22 @@ Verifiser priser via microsoft_docs_search."
|
|||
- Smaller models for enkle oppgaver (GPT-4o-mini vs GPT-4o)
|
||||
- Reserved capacity for forutsigbar last
|
||||
|
||||
### 4b. Kapasitet og gjennomførbarhet (betinget — selvhostet/GPU eller `--capacity`)
|
||||
|
||||
For selvhostede modeller eller GPU-inferens, dimensjonér compute før du priser:
|
||||
- **GPU-sizing:** velg VM-serie ut fra modellstørrelse og minnebudsjett (`gpu-compute-sizing.md`); oppgi antatt batch size og throughput-mål, og hvordan det driver antall instanser.
|
||||
- **Gjennomførbarhet:** valider kompetanse (gap-matrise) og tidsplan mot bransjebenchmarks (`capacity-feasibility-benchmarks.md`) — et estimat som ignorerer kompetansegap er ikke realistisk.
|
||||
|
||||
| Komponent | Modell/krav | GPU VM-serie | Instanser | Månedlig (NOK) |
|
||||
|-----------|-------------|--------------|-----------|-----------------|
|
||||
| Inferens | … | … | … | … |
|
||||
|
||||
### 5. Neste steg
|
||||
|
||||
Tilby:
|
||||
- `/architect:compare` — sammenlign med alternativ plattform
|
||||
- `/architect:license` — detaljert lisensanalyse
|
||||
- `/architect:businesscase` — NNV/gevinst med dette estimatet som input
|
||||
- Justere estimat med andre parametere
|
||||
|
||||
## Retningslinjer
|
||||
|
|
|
|||
|
|
@ -23,11 +23,13 @@ Presenter følgende oversikt til brukeren i et ryddig, tabellbasert format.
|
|||
| `/architect:compare` | Sammenlign Microsoft AI-plattformer for et gitt scenario |
|
||||
| `/architect:security` | Kjør sikkerhets- og compliance-vurdering |
|
||||
| `/architect:cost` | Estimer kostnader for en foreslått arkitektur |
|
||||
| `/architect:businesscase` | Forretningscase med NNV og DFØ-gevinstrealisering |
|
||||
| `/architect:adr` | Opprett en Architecture Decision Record (ADR) |
|
||||
| `/architect:research` | Dypdykk i et spesifikt Microsoft AI-tema |
|
||||
| `/architect:poc` | Generer en POC-plan med evalueringskriterier |
|
||||
| `/architect:license` | Kartlegg lisensbehov for en løsning |
|
||||
| `/architect:migrate` | Planlegg migrasjonssti mellom plattformer |
|
||||
| `/architect:anskaffelse` | AI-anskaffelse — kravspesifikasjon, leverandørevaluering, terskelverdier |
|
||||
| `/architect:utredning` | AI-arkitekturutredning v2 — fil-basert orkestrering, TeamCreate, 3-fase KOMPLEKS |
|
||||
| `/architect:review` | Kjør arkitekturgjennomgang mot norske offentlig sektor-krav |
|
||||
| `/architect:diagram` | Generer arkitekturdiagram med Imagen 3 |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue