ms-ai-architect/commands/help.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

118 lines
6 KiB
Markdown

---
name: architect:help
description: Vis oversikt over alle tilgjengelige architect-kommandoer og agenter
argument-hint: "[emne for mer detaljer]"
allowed-tools: Read, Glob
model: opus
---
# /architect:help - Plugin Kommandooversikt
Vis en komplett oversikt over architect-pluginens tilgjengelige kommandoer, agenter og kunnskapsbaser.
## Instruksjoner
Presenter følgende oversikt til brukeren i et ryddig, tabellbasert format.
## Kommandoer
| Kommando | Beskrivelse |
|----------|-------------|
| `/architect` | Start en strukturert arkitekturrådgivning med Cosmo Skyberg |
| `/architect:help` | Denne oversikten |
| `/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:design` | Sektor-nøytralt Solution Architecture Document (SAD) — mellombane mellom samtale og full utredning |
| `/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:vendor` | Leverandørvurdering (tredjepart/SaaS due diligence) — dataresidens, DPA, Schrems II, AI Act-deployer |
| `/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 |
| `/architect:ros` | Gjennomfør ROS-analyse (Risiko- og Sårbarhetsanalyse) for et AI-system |
| `/architect:dpia` | Gjennomfør DPIA/PVK for et AI-system |
| `/architect:summary` | Generer teknisk sammendrag og beslutningsnotat |
| `/architect:export` | Eksporter arkitekturdokument til PDF |
| `/architect:generate-skills` | Generer kunnskapsfiler med MCP-research (intern) |
| `/architect:kb-update` | Manuell KB-refresh — poll sitemaps, oppdater endrede filer, commit |
| `/architect:classify` | EU AI Act-klassifisering: risikonivå + rolle |
| `/architect:requirements` | Konkrete AI Act-krav basert på risikonivå og rolle |
| `/architect:transparency` | Generer Art. 13/50 transparensnotis på norsk |
| `/architect:frimpact` | FRIA (Art. 27) — obligatorisk for offentlig sektor |
| `/architect:conformity` | Samsvarsvurdering (Art. 43) — sjekkliste + erklæring |
| `/architect:onboard` | Onboard pluginen med virksomhetsspesifikk kontekst |
## Agenter
| Agent | Formål |
|-------|--------|
| `research-agent` | MCP-isolert research med microsoft-learn |
| `security-assessment-agent` | Sikkerhets- og compliance-vurdering (6 dimensjoner) |
| `cost-estimation-agent` | Kostnadsestimering i NOK med TCO-sammenligning |
| `adr-writer-agent` | Automatisk generering av ADR-dokumenter |
| `license-mapper-agent` | Kartlegging av lisens-til-kapabilitet |
| `architecture-review-agent` | Arkitekturgjennomgang mot norske offentlig sektor-krav (6 dimensjoner) |
| `diagram-generation-agent` | Arkitekturdiagrammer med Imagen 3 (mcp-image) |
| `ros-analysis-agent` | ROS-analyse med 7 dimensjoner og AI-trusselbibliotek |
| `dpia-agent` | DPIA/PVK med risikomatrise og tiltakstabell |
| `summary-agent` | Teknisk sammendrag og beslutningsnotat fra arkitekturvurderinger |
| `ai-act-assessor` | EU AI Act-klassifisering, forpliktelser og compliance |
| `onboarding-agent` | Strukturert onboarding-intervju for virksomhetstilpasning |
## Kunnskapsbaser
### Plattformer (`references/platforms/`)
- Azure AI Foundry, Copilot Studio, M365 Copilot, Power Platform
### Arkitektur (`references/architecture/`)
- Decision trees, Security, ADR-template, Cost models
- Licensing matrix, POC template, Migration patterns
- Public sector checklist (norsk offentlig sektor)
- AI-utredningsmal (utredningsinstruksen + Digdir + AI Act)
### Utvikling (`references/development/`)
- Microsoft Agent Framework
## MCP-verktøy
Pluginen bruker følgende MCP-servere:
**microsoft-learn** — Offisiell Microsoft dokumentasjon:
- `microsoft_docs_search` — Søk i offisiell dokumentasjon
- `microsoft_docs_fetch` — Hent fullstendig sideinnhold
- `microsoft_code_sample_search` — Finn kodeeksempler
**mcp-image** — Bildegenerering med Imagen 3:
- `mcp__mcp-image__generate_image` — Generer arkitekturdiagrammer
## Typisk arbeidsflyt
0. **Onboard:** `/architect:onboard` — tilpass til din virksomhet (valgfritt)
1. **Start:** `/architect` — beskriv ditt forretningsproblem
2. **Utred:** `/architect:utredning` — full utredning for offentlig sektor
3. **Utforsk:** `/architect:compare` — sammenlign plattformalternativer
4. **Vurder:** `/architect:ros` + `/architect:security` + `/architect:cost` + `/architect:review` — risiko, sikkerhet, kostnad og compliance
5. **Visualiser:** `/architect:diagram` — generer arkitekturdiagrammer
6. **Oppsummer:** `/architect:summary` — teknisk sammendrag og beslutningsnotat
7. **Beslut:** `/architect:adr` — dokumenter beslutningen
8. **Planlegg:** `/architect:poc` — lag POC-plan for validering
### Privat sektor / enterprise
Offentlig-banen over er én av to. For privat/regulert sektor (uten utredningsinstruksen):
1. **Klassifiser:** `/architect:classify` — AI Act gjelder alle providers/deployere
2. **Design:** `/architect:design` — sektor-nøytralt Solution Architecture Document
3. **Vurder:** `/architect:security` + `/architect:cost` + `/architect:ros` (finans → DORA/Finanstilsynet aktiveres automatisk)
4. **Leverandør:** `/architect:vendor` — due diligence på ekstern SaaS/AI
5. **Beslut:** `/architect:adr`
## Om argumentet
Hvis brukeren angir et emne (f.eks. `/architect:help security`), vis utvidet informasjon om det spesifikke emnet istedenfor full oversikt.