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