open/ms-ai-architect
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions
ms-ai-architect/docs/playground-v2-spec.md
Kjell Tore Guttormsen baa2d0220b feat(ultraplan-local): v1.6.0 — /ultraresearch-local deep research command 
Add /ultraresearch-local for structured research combining local codebase
analysis with external knowledge via parallel agent swarms. Produces research
briefs with triangulation, confidence ratings, and source quality assessment.

New command: /ultraresearch-local with modes --quick, --local, --external, --fg.
New agents: research-orchestrator (opus), docs-researcher, community-researcher,
security-researcher, contrarian-researcher, gemini-bridge (all sonnet).
New template: research-brief-template.md.

Integration: --research flag in /ultraplan-local accepts pre-built research
briefs (up to 3), enriches the interview and exploration phases. Planning
orchestrator cross-references brief findings during synthesis.

Design principle: Context Engineering — right information to right agent at
right time. Research briefs are structured artifacts in the pipeline:
ultraresearch → brief → ultraplan --research → plan → ultraexecute.

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

4 KiB
Raw Permalink 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