open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions
ktg-plugin-marketplace/plugins/ms-ai-architect/docs/playground-v2-spec.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

4 KiB
Raw Blame History

Playground v2: Full Self-Service Architecture Pipeline

Spec document for the Azure AI Architecture Playground v2 rewrite. Status: Approved plan, ready for implementation.

Definition

Playground er det visuelle inntakspunktet til ms-ai-architect-pluginen. Den transformerer "jeg har et problem" til "kjor disse kommandoene med dette inputet, i denne rekkefolgem, og forvent disse leveransene."

Playground ER Playground er IKKE
Visuell intake-wizard for arkitekturbeslutninger Kodegenerator eller prosjekt-scaffolding
Kapabilitetskatalog med intelligent filtrering Statisk dokumentasjon eller lesestoff
Command-pipeline-generator for /architect-kommandoer Erstatning for Claude — den FEEDER Claude
Selvbetjent for alle nivaer (nybegynner til ekspert) Kun for tekniske arkitekter

Pipeline: 5 steg

Steg 1: INTAKE — "Hvem er du og hva trenger du?"

  • Organisasjonstype, sektor, storrelse (dropdown/cards)
  • Eksisterende lisensportefolje (checkboxes: E3, E5, Copilot, Azure, Power)
  • Compliance-krav (Schrems II, DPIA, AI Act, NSM)
  • Dataresidens (Norway East, EU, Global)
  • Problemstilling (velg scenario eller skriv fritekst)
  • Brukerantall og estimert volum
  • Tidsramme for prosjekt

Steg 2: EXPLORE — "Hvilke kapabiliteter matcher?"

  • Filtrert kapabilitetskatalog (grocery store)
  • Items som ikke matcher intake-constraints er graaet ut
  • Scenario-valg pre-fyller handlekurven med begrunnelser
  • Ekspertmodus: full browsing pa tvers av aisles

Steg 3: CONFIGURE — "Juster arkitekturen"

  • Handlekurv med valgte kapabiliteter
  • Juster parametere: brukerantall, volum, budsjetttak
  • Live kostnadsestimat
  • Compliance-sjekk: gront/gult/rodt lys per krav

Steg 4: REVIEW — "Her er arkitekturen din"

  • Arkitekturoversikt
  • Kostnadsestimat (P10/P50/P90)
  • Compliance traffic lights
  • Risikoflagg og anbefalinger

Steg 5: EXPORT — "Her er hva du skal gjore videre"

  • A: Strukturert prompt (for Claude)
  • B: Command pipeline med pre-fylte argumenter
  • C: Arkitektur-brief (Markdown)
  • D: JSON Decision Record

UX: Tre brukernivaer

Niva Navn Flyt Klikk til output
Nybegynner "Guide meg" Wizard: intake -> auto-fill -> review -> export 5-6 klikk
Mellom "La meg utforske" Intake -> browse aisles -> manual selection -> review -> export 8-10 klikk
Ekspert "Jeg vet hva jeg vil" Hopp til browse -> manual selection -> export 3-4 klikk

Data Model Extensions (vs v1)

Ny dimensjon Kilde Pavirker
skill_req per item citizen/pro/devops UX-filtering, anbefaling
setup_days per item Estimert dager POC-planlegging
user_rec per item Anbefalingstekst Brukerantall-veiledning
Brukerantall-input Intake-felt /architect:cost pre-fill
Volum/dag-input Intake-felt /architect:cost pre-fill
Tidsramme Intake-felt /architect:poc pre-fill
Plattform-anbefaling per scenario COMMAND_PIPELINES /architect:compare pre-fill
Command pipeline per scenario COMMAND_PIPELINES Export steg 5B

Command Pipeline Mapping

8 av 17 /architect:*-kommandoer kan pre-fylles:

  1. /architect:utredning — scenario + org + lisenser + compliance + kapabiliteter
  2. /architect:compare — topp 2 plattformer basert pa valg
  3. /architect:security — plattform + compliance-krav
  4. /architect:cost — plattform + brukere + volum
  5. /architect:dpia — scenario + persondata (kun nar relevant)
  6. /architect:diagram — arkitekturtype + scenario
  7. /architect:summary — genereres fra foregaende output
  8. /architect:adr — genereres fra foregaende output

Verifikasjon

  1. Apne HTML i browser — alt fungerer offline
  2. Nybegynner-flyt: "Guide meg" -> statlig etat -> E5 + Azure -> RAG-chatbot -> review -> kopier pipeline
  3. Ekspert-flyt: Hopp til Browse -> velg 5 items -> export JSON -> verifiser valid JSON
  4. Alle 4 output-formater produserer korrekt output
  5. Command pipeline har riktige pre-fylte argumenter