ms-ai-architect/commands/adr.md
Kjell Tore Guttormsen 5b05009b44 fix(ms-ai-architect): RX-P1 installert-modus-hardening — ${CLAUDE_PLUGIN_ROOT}-forankring + scoped agent-delegering [skip-docs]
- Forankre 115 skills/-KB-stier med ${CLAUDE_PLUGIN_ROOT}/ i 26 commands + 10 agenter
  (relative stier resolver kun dev-modus; installert fra katalog mistet subagentene KB-last)
- Foren delegering til registrert scoped navn ms-ai-architect:<agent>
  (var: architect:X feil-namespace + bare navn + general-purpose+"Read agents/X.md")
- Dropp redundant "Read/Les agents/X.md"-instruks (scoped agent auto-laster egen kropp)
- Bevar per-kommando KB-kontrakt inkl. dpia betinget data-residens-ruting (Option B)
- generate-skills: sonnet→opus (opus-direktiv), {PLUGIN_ROOT}→${CLAUDE_PLUGIN_ROOT};
  git-pathspecs holdt repo-relative
- plugin.json repository: ktg-plugin-marketplace→ms-ai-architect (polyrepo egen repo)
- validate-plugin.sh Check 6 (install-safety lint: sti + delegering + opus-only) + node-wrapper i kanonisk suite
2026-07-15 10:59:04 +02:00

2.4 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 Microsoft 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(ms-ai-architect:adr-writer-agent): "
Generate an ADR based on the current session context.
Beslutning: [beslutningstittel]
Bakgrunn: [forretningskontekst]
Alternativer: [vurderte alternativer]
Valgt løsning: [beslutning med begrunnelse]
Les også: ${CLAUDE_PLUGIN_ROOT}/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