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

2.5 KiB

name description argument-hint allowed-tools model
architect:adr Generer en Architecture Decision Record (ADR) basert på sesjonens arkitekturbeslutninger [valgfritt: tittel for ADR] Read, Glob, Grep, Task, Write opus

/architect:adr - Architecture Decision Record

Generer en ADR i MADR v3.0-format basert på arkitekturbeslutninger tatt i denne sesjonen. Ingen persona — dette er et dokumentasjonsverktøy.

Instruksjoner

1. Identifiser beslutning

Gjennomgå samtalehistorikken og identifiser arkitekturbeslutninger:

  • Plattformvalg (Copilot Studio vs Microsoft Foundry, etc.)
  • Deployment-modeller (Standard vs PTU, serverless vs managed)
  • Dataarkitektur (RAG-strategi, søketjeneste, datakilder)
  • Sikkerhetsmodeller (identity, network, content safety)
  • Integrasjonsvalg (connectors, API-er, protocols)

Hvis flere beslutninger finnes, spør brukeren hvilken som skal dokumenteres. Hvis ingen tydelig beslutning finnes, hjelp brukeren å formulere den.

2. Samle kontekst

Fra samtalehistorikken, ekstraher:

  • Bakgrunn: Forretningskonteksten som drev beslutningen
  • Problem statement: Det spesifikke arkitekturproblemet
  • Beslutningsdrivere: Hva som var viktigst (kostnad, sikkerhet, tid, kompetanse)
  • Alternativer: Hvilke løsninger ble vurdert
  • Valgt løsning: Hva ble besluttet og hvorfor
  • Pro/con: Fordeler og ulemper per alternativ

Hvis /architect:compare ble brukt, inkluder sammenligningstabellen. Hvis /architect:security ble brukt, inkluder sikkerhetsscoren. Hvis /architect:cost ble brukt, inkluder kostnadsestimatet.

3. Deleger til adr-writer-agent

Bruk Task-verktøyet til å delegere ADR-generering:

Task(general-purpose): "Read agents/adr-writer-agent.md for your role and instructions.
Generate an ADR based on the current session context.
Beslutning: [beslutningstittel]
Bakgrunn: [forretningskontekst]
Alternativer: [vurderte alternativer]
Valgt løsning: [beslutning med begrunnelse]
Les også: skills/ms-ai-advisor/references/architecture/adr-template.md"

4. Skriv til fil

Spør brukeren om plassering. Foreslå:

  • docs/adr/ADR-NNN-[slug].md (prosjektets ADR-mappe)
  • Bruk Write-verktøyet til å lagre filen

Retningslinjer

  • ADR skal være selvforsynt — lesbar uten sesjonskontekst
  • ALLTID inkluder compliance-seksjon, selv om den er "Ikke vurdert"
  • Bruk faktisk info fra sesjonen, ikke generisk fyll
  • Norsk prosa, engelske tekniske termer
  • Hold ADR fokusert — én beslutning per dokument