ktg-plugin-marketplace/plugins/ms-ai-architect/commands/diagram.md
Kjell Tore Guttormsen 6a7632146e feat(ms-ai-architect): add plugin to open marketplace (v1.5.0 baseline)
Initial addition of ms-ai-architect plugin to the open-source marketplace.
Private content excluded: orchestrator/ (Linear tooling), docs/utredning/
(client investigation), generated test reports and PDF export script.
skill-gen tooling moved from orchestrator/ to scripts/skill-gen/.

Security scan: WARNING (risk 20/100) — no secrets, no injection found.
False positive fixed: added gitleaks:allow to Python variable reference
in output-validation-grounding-verification.md line 109.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-07 17:17:17 +02:00

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