ms-ai-architect/commands/help.md
Kjell Tore Guttormsen 03d596e4ec docs(ms-ai-architect): KB-refresh tema-b — Foundry-navnesveip «Azure AI Foundry»→«Microsoft Foundry» (233 filer)
Verifisert mot offisiell MS-doc (juni 2026): «Microsoft Foundry» er det
gjeldende produkt-/portalnavnet; «Foundry (classic)» = gamle «Azure AI Foundry»
(/azure/foundry/ vs /azure/foundry-classic/). Premiss bekreftet før sveip.

Multi-regel, IKKE naiv s/Azure AI Foundry/Microsoft Foundry/ — MS dropper
«Azure AI» (legger IKKE til «Microsoft») for to produktvarianter:
- «Azure AI Foundry Agent[ Service|s]» → «Foundry Agent Service/Agents» (MS-form)
- «Azure AI Foundry Models» → «Foundry Models» (i «Azure OpenAI in Foundry Models»)
- «Azure AI Foundry SDK» → «Microsoft Foundry SDK» (operatør-valg)
- «Azure AI Foundry portal/project» + generisk → «Microsoft Foundry»
- Pre-eksisterende «Microsoft Foundry Models» (4) normalisert → «Foundry Models»

Bevart: «Azure OpenAI», «Azure AI Inference SDK», «Azure AI Search»,
«Azure AI Services», kode-IDer. Historisk ref «(tidligere Azure AI Foundry)»
i model-catalog-2026.md beskyttet via lookbehind. URL /azure/ai-foundry/→
/azure/foundry/ kun i owasp-llm-top10 (KB-ref); docs/-filer deferred.

Scope: skills (inkl. 3 SKILL.md) + commands + agents + README + CLAUDE.
Ekskludert: docs/ (interne), playground/+tests/ fixtures (testdata),
CHANGELOG.md (historisk logg), STATE.md (gitignored).

3 SKILL.md endret (advisor/engineering/security) → judge-cache teknisk
invalidert for disse, men scorer uendret: advisor 91, eng/gov/infra/sec 96
(alle ≥90). validate 239/0. 0 «Azure AI Foundry» igjen (utenom bevart ref).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 21:00:27 +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/`)
- Microsoft 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.