open/ms-ai-architect
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions
ms-ai-architect/commands/diagram.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

3.4 KiB
Raw Blame History

name description argument-hint allowed-tools model
architect:diagram Generer et arkitekturdiagram for en Microsoft AI-løsning [type] for [scenario] Read, Glob, Task, mcp__mcp-image__generate_image 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