Kjell Tore Guttormsen
03d596e4ec
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>
66 lines
2.5 KiB
Markdown
66 lines
2.5 KiB
Markdown
---
|
|
name: architect:adr
|
|
description: Generer en Architecture Decision Record (ADR) basert på sesjonens arkitekturbeslutninger
|
|
argument-hint: "[valgfritt: tittel for ADR]"
|
|
allowed-tools: Read, Glob, Grep, Task, Write
|
|
model: 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
|