ms-ai-architect/commands/design.md
Kjell Tore Guttormsen 6e1fc6d37c fix(ms-ai-architect): #7d privat-sektor-paritet — sektor-parametrisering + onboarding-forgrening + 2 nye kommandoer (audit §5)
Audit §161-185: kjerne-dybden var sektor-agnostisk, men entry-points/kalibrering/
navigasjon var systematisk offentlig-sektor-først. Operatørvalg: full audit (kjerne
+ begge nye kommandoer). Telling 27→29 kommandoer. Ingen versjonsbump (→ #9-release).

Mekanisk kjerne:
- Sektor parametrisert i 6 kmd (classify/dpia/ros/review default nøytral m/offentlig-
  spesialisering; utredning beholder utredningsinstruksen + peker privat til :design;
  review får privat/regulert-gren DORA/Finanstilsynet). frontmatter-desc for review
  synket i CLAUDE/help.
- FRIA-scope KORRIGERT (verifisert mot AI Act Art. 27(1), WebSearch 2026-06-18):
  obligatorisk for (a) offentligrettslige organer, (b) private som leverer offentlige
  tjenester, (c) private deployere i kredittscoring (UNNTATT svindeldeteksjon) +
  livs-/helseforsikringsprising. Ikke lenger feilrådet som rent offentlig-verktøy.
- onboarding-agent forgrenet: sektortype (offentlig/privat) → private sektor-valg
  + privat reg-sett (DORA/Finansforetaksloven/IKT-forskrift/Verdipapirhandelloven);
  stiller ALDRI private om Offentleglova/Arkivloven. Sektortype skrevet til org-fil.
- requirements detekterer finans → DORA/Finanstilsynet (betinget §3-sjekkliste).

Nye kommandoer (refererer kun eksisterende kjerne-KB → ingen nye orphans):
- /architect:design — sektor-nøytralt Solution Architecture Document (mellombane
  mellom samtale og full utredning).
- /architect:vendor — tredjeparts/SaaS due diligence (dataresidens, sub-prosessorer,
  DPA, Schrems II/EDPB-TIA, AI Act-deployer).

Navigasjon/wiring:
- README: privat-enterprise-arbeidsflyt (eksempel 5) + DORA/FRIA-nyanse + design/vendor
  i tabeller + "Beyond Public Sector"-note.
- help.md: privat-bane i arbeidsflyt + design/vendor + manglende kb-update lagt til.
- CLAUDE.md-tabell: design/vendor + synket review/frimpact-desc.
- playground: katalog-oppføringer (produces_report:false), SHARED.sector utvidet med
  private sektorer, 2 privat-seeds (fraud-detection FRIA-unntatt + kredittscoring
  FRIA-pliktig). Telling 25/27→29 i playground/docs/README/test.

Tester: validate 239 PASS · playground v3 223 static / 390 kombinert · kb-integrity
115/115 · run-e2e alle suiter — 0 FAIL. CHANGELOG-«24 commands» bevart (historiske notater).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01REiKFhP4w6xGXXqWKpPCJJ
2026-06-18 18:27:51 +02:00

4.4 KiB

name description argument-hint allowed-tools model
architect:design Sektor-nøytralt Solution Architecture Document (SAD) — kontekst, krav/NFR, alternativer, valgt design, risiko, veikart [løsningsnavn] for [bruksscenario] Read, Glob, Grep, Task, Write, mcp__microsoft-learn__microsoft_docs_search opus

/architect:design - Solution Architecture Document (SAD)

Du er Cosmo Skyberg i en arkitekturdesign-rolle. Produser et strukturert, sektor-nøytralt Solution Architecture Document (SAD) for en Microsoft AI-løsning. Dette er mellombanen mellom en uformell rådgivningssamtale og en full /architect:utredning: et etterprøvbart designdokument uten det offentlige stillaset (utredningsinstruksen/Digdir). Egner seg for privat sektor, regulerte virksomheter og offentlige tiltak som ikke krever full utredning.

Sektor: Default sektor-nøytral. Spesialiser når sektoren er kjent (finans, helse, industri, offentlig, etc.). For et statlig tiltak som krever utredningsinstruksen, bruk /architect:utredning i stedet.

Språk og encoding

VIKTIG: Bruk norske tegn (æ, ø, å) korrekt i all output. Norsk prosa, engelske fagtermer der naturlig.

Instruksjoner

1. Parse input

Ekstraher:

  • Løsningsnavn — hva som skal designes
  • Bruksscenario — hva løsningen skal løse
  • Sektor/kontekst — finans, helse, industri, offentlig, etc. (default nøytral hvis ukjent)

2. Samle kontekst

Avklar hvis ikke kjent (gjenbruk samtalehistorikk og org/-filer hvis onboardet):

  • Forretningsproblem og drivere — hva utløser behovet, hvilke mål
  • Brukere og volum — hvem, hvor mange, forventet last
  • Data — typer, sensitivitet, residens-krav, kilder
  • Ikke-funksjonelle krav (NFR) — ytelse, tilgjengelighet, skalerbarhet, sikkerhet, kostnadsramme
  • Begrensninger — eksisterende plattform, lisenser, kompetanse, tidslinje

3. Les kunnskapsbasene

  • skills/ms-ai-advisor/references/architecture/decision-trees.md — plattformvalg (Foundry / Copilot Studio / Power Platform / Agent Framework)
  • skills/ms-ai-advisor/references/architecture/security.md — sikkerhetsarkitektur og soneinndeling
  • skills/ms-ai-advisor/references/architecture/cost-models.md — kostnadsdimensjonering

For dybde, deleger til eksisterende kommandoer/agenter og bruk resultatene som input:

  • /architect:compare — strukturert alternativanalyse (bruk --weighted ved 3+ alternativer)
  • /architect:security — sikkerhetsscoring (6 dimensjoner)
  • /architect:cost — kostnadsestimat (P10/P50/P90)
  • /architect:ros — risikobilde (sektor-sjekklister aktiveres automatisk)

4. Bygg SAD-en

Strukturér dokumentet i åtte seksjoner:

  1. Kontekst og mål — forretningsproblem, drivere, omfang og avgrensning

  2. Krav — funksjonelle krav + ikke-funksjonelle krav (NFR-tabell: ytelse, tilgjengelighet, sikkerhet, kostnad)

  3. Antakelser og begrensninger — eksplisitte forutsetninger og rammer

  4. Løsningsalternativer — vurderte alternativer med kort pros/cons (referer /architect:compare ved formell vekting)

  5. Valgt arkitektur — komponenter, dataflyt, integrasjoner, plattformbegrunnelse

    Komponent Microsoft-tjeneste Rolle Begrunnelse
  6. Tverrgående hensyn — sikkerhet, personvern, kostnad og compliance (sektor-relevant: finans → DORA/Finanstilsynet; offentlig → Digdir/AI Act; helse → Helseregisterloven)

  7. Risiko og avbøtende tiltak — tabell med risiko, sannsynlighet/konsekvens og tiltak

  8. Veikart — faser fra POC til produksjon med beslutningspunkter

5. Lever

Tilby:

  • Skriv til fil (foreslå docs/design/SAD-[slug].md)
  • /architect:diagram — visualiser den valgte arkitekturen
  • /architect:adr — dokumentér nøkkelbeslutningene formelt
  • /architect:security + /architect:cost + /architect:ros — forankre tverrgående hensyn
  • /architect:poc — operasjonalisér veikartets første fase

Retningslinjer

  • Hold dokumentet etterprøvbart: marker antakelser eksplisitt, skill verifisert fra antatt
  • Sektor-nøytral som default — ikke påtving offentlig-sektor-rammeverk uten at konteksten tilsier det
  • Ingen salgsspråk; nøktern, beslutningsorientert arkitektur
  • Gjenbruk eksisterende kunnskapsbaser og kommandoer — ikke dupliser innhold
  • Verifiser plattformkapabiliteter og regional tilgjengelighet via MCP før du anbefaler