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>
89 lines
3.4 KiB
Markdown
89 lines
3.4 KiB
Markdown
---
|
|
name: architect:diagram
|
|
description: Generer et arkitekturdiagram for en Microsoft AI-løsning
|
|
argument-hint: "[type] for [scenario]"
|
|
allowed-tools: Read, Glob, Task, mcp__mcp-image__generate_image
|
|
model: opus
|
|
---
|
|
|
|
# /architect:diagram - Diagramgenerering
|
|
|
|
Generer profesjonelle arkitekturdiagrammer for Microsoft AI-løsninger ved hjelp av Imagen 3.
|
|
|
|
## Instruksjoner
|
|
|
|
### 1. Parse input
|
|
|
|
Ekstraher fra argumentet:
|
|
- **Type** — Diagramtype (se tabell under). Default: `architecture`
|
|
- **Scenario** — Hva diagrammet skal vise
|
|
|
|
**Diagramtyper:**
|
|
|
|
| Type | Beskrivelse | Eksempel |
|
|
|------|-------------|---------|
|
|
| `architecture` | Komplett arkitekturoversikt med alle komponenter | `/architect:diagram architecture for Copilot Studio chatbot` |
|
|
| `security` | Sikkerhetssoner og tilgangskontroll | `/architect:diagram security for Microsoft Foundry med PII-data` |
|
|
| `dataflow` | Dataflyt og RAG-pipeline | `/architect:diagram dataflow for RAG med SharePoint og Azure AI Search` |
|
|
| `problem` | Før/etter-sammenligning | `/architect:diagram problem for manuell saksbehandling → AI-assistert` |
|
|
| `roadmap` | Implementeringstidslinje | `/architect:diagram roadmap for 3-fase Copilot Studio-utrulling` |
|
|
|
|
Hvis type ikke er spesifisert, bruk `architecture` som default.
|
|
|
|
### 2. Samle kontekst
|
|
|
|
Hvis scenarioet er beskrevet i nok detalj, gå direkte til steg 3.
|
|
|
|
Hvis kontekst mangler, still korte spørsmål:
|
|
- Hvilke Microsoft-tjenester er involvert?
|
|
- Hvem er brukerne? (internt/eksternt)
|
|
- Hva er dataflyten? (for dataflow/RAG)
|
|
- Hva er nåsituasjonen? (for problem-type)
|
|
- Hva er fasene? (for roadmap-type)
|
|
|
|
### 3. Deleger til diagram-generation-agent
|
|
|
|
Kjør `diagram-generation-agent` via Task:
|
|
|
|
```
|
|
Task(general-purpose): "Read agents/diagram-generation-agent.md for your role and instructions.
|
|
Generer [type]-diagram for [scenario].
|
|
Komponenter: [liste over tjenester].
|
|
Kontekst: [ekstra detaljer].
|
|
Les: skills/ms-ai-advisor/references/architecture/diagram-prompt-templates.md"
|
|
```
|
|
|
|
## Format Parameter
|
|
- Default: Imagen 3 via mcp-image (generates PNG)
|
|
- `--format mermaid`: Generate Mermaid.js diagram definition instead
|
|
- `--format text`: Text-based architecture description (fallback)
|
|
|
|
When `--format mermaid` is specified, generate a Mermaid.js diagram definition instead of using Imagen 3. When `--format text` is specified, generate a text-based ASCII architecture description as fallback.
|
|
|
|
### 4. Presenter resultat
|
|
|
|
Vis det genererte diagrammet (eller fallback-prompten) til brukeren.
|
|
|
|
Tilby:
|
|
- Å generere flere diagramtyper for samme scenario
|
|
- Å justere komponenter og regenerere
|
|
- Å bruke prompten manuelt i en annen bildegenerator
|
|
- Å regenerere i et annet format (`--format mermaid` eller `--format text`)
|
|
|
|
## Brukseksempler
|
|
|
|
```
|
|
/architect:diagram architecture for Copilot Studio kundeservice-agent
|
|
/architect:diagram security for Microsoft Foundry med sensitive persondata
|
|
/architect:diagram dataflow for RAG-pipeline med SharePoint, Azure AI Search og GPT-4o
|
|
/architect:diagram problem for manuell dokumenthåndtering → AI-klassifisering
|
|
/architect:diagram roadmap for 4-fase Copilot Studio-implementering
|
|
/architect:diagram for intern chatbot med M365 Copilot
|
|
```
|
|
|
|
## Integrasjon med andre kommandoer
|
|
|
|
Denne kommandoen kan brukes standalone, eller som del av:
|
|
- `/architect:utredning` — Genererer diagrammer for S8.2, S2.1, S4.3, S5.1, S9.1
|
|
- `/architect` — Fase 7 (Visualisering) delegerer hit
|
|
- `/architect:poc` — Kan legge ved arkitekturdiagram i POC-planen
|