--- 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 Azure AI 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 Azure AI 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