6a7632146e
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>
104 lines
4 KiB
Markdown
104 lines
4 KiB
Markdown
# 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
|