# 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
