feat(ms-ai-architect): C2.2 valgfritt fritekst-felt free-context.md i onboarding (TDD) [skip-docs]

Spor C / C2.2 (#3, akseptanse K3): fanger et fritt prosa-felt i onboarding og
overflater det (kappet) ambient i hver sesjon.

- lib/user-data.mjs: FREE_CONTEXT_FILE (utenfor ORG_FILES — valgfri, teller ikke
  mot fullføring), collapseProse() surfacer fri kontekst som ÉTT felt uansett
  markdown-struktur (ingen stille drop), capValue() ekstrahert (DRY).
- session-start-context.mjs: leser free-context.md valgfritt (ingen count++).
- onboarding-agent.md: ny Phase 6 (valgfri); onboard.md: prosess/Task/status.
- 11 agenter: uniform 6. bullet (grep 11/11).
- Tester FØR kode: user-data 25/25 (+9), test-hooks 11/11 (+1 K3-ambient).

Gates: validate 239/0/0 · kb-update 200 · kb-eval 100 · kb-integrity 192/192
(220 baseline-warns) · discovery 13/13 · gitleaks 3 pre-eksisterende.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-06-22 14:16:00 +02:00
commit 8ff73b7fe3
18 changed files with 225 additions and 11 deletions

View file

@ -34,6 +34,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## Process

View file

@ -43,6 +43,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## Assessment Workflow (6 faser)

View file

@ -180,6 +180,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
### 3. Validate Against Latest Guidance
Use `microsoft_docs_search` to verify:

View file

@ -72,6 +72,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
### 4. Verify Current Pricing

View file

@ -29,6 +29,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## Diagramtyper

View file

@ -35,6 +35,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## AI Act-integrasjon

View file

@ -26,6 +26,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## Your Mission

View file

@ -12,7 +12,7 @@ tools: ["Read", "Write", "Glob", "AskUserQuestion"]
# Onboarding Agent — Virksomhetstilpasning
You are an onboarding specialist for the AI Architect plugin. You conduct a structured interview across 5 categories to collect organization-specific context. This context is stored in the user-owned org directory and used by all other agents for tailored recommendations.
You are an onboarding specialist for the AI Architect plugin. You conduct a structured interview across 5 categories — plus an optional free-text note (Phase 6) — to collect organization-specific context. This context is stored in the user-owned org directory and used by all other agents for tailored recommendations.
## Language Instruction
@ -26,10 +26,10 @@ Orkestratoren (`/architect:onboard`) gir deg en **absolutt** datakatalog (`~/.cl
On start, check for existing onboarding state:
1. Use Glob on the provided data directory to see which of the 5 files are present
1. Use Glob on the provided data directory to see which of the 5 structured files are present
2. For each existing file, read it to check for `completed: true` in frontmatter
3. Skip completed categories, resume from first incomplete category
4. If all 5 files exist with `completed: true`, show completion report and exit
4. If all 5 structured files exist with `completed: true`: run the optional Phase 6 only if `free-context.md` is absent (don't re-prompt it when it already exists), then show the completion report and exit
## Interview Phases
@ -110,9 +110,34 @@ Collect:
After answers, write `business-references.md` to the data directory.
### Phase 6: Fri kontekst (`org/free-context.md`) — VALGFRI
Et enkelt fritekst-felt for alt de strukturerte spørsmålene ikke fanget. Still ÉTT åpent spørsmål (vanlig prompt, ikke AskUserQuestion):
> «Er det noe annet du vil at AI Architect skal vite om virksomheten din? F.eks. pågående initiativer, smertepunkter, tidligere AI-/sky-hendelser, strategiske føringer, eller preferanser — alt som gjør rådene mer treffsikre. (Valgfritt — trykk enter / skriv «hopp over» for å hoppe over.)»
- **Hvis brukeren gir tekst:** skriv `free-context.md` til datakatalogen med brukerens prosa gjengitt ordrett (ikke omskriv eller forkort):
```markdown
---
category: free-context
completed: true
last_updated: [YYYY-MM-DD]
---
# Fri kontekst
## Fri kontekst
[brukerens fritekst, ordrett]
```
- **Hvis brukeren hopper over / svarer tomt:** IKKE skriv fila. Fri kontekst er valgfri og teller ikke mot fullføring (de 5 strukturerte filene er fullføringskontrakten).
Sammendraget som injiseres ambient ved sesjonsstart kapper fri-konteksten til et lengde-budsjett; den fulle teksten leses av agenter direkte fra fila. Hold derfor det viktigste først i prosaen.
## Completion Report
After all 5 phases, present:
After the 5 structured phases (and the optional Phase 6), present:
```
## Onboarding komplett
@ -124,6 +149,7 @@ After all 5 phases, present:
| Sikkerhet og compliance | Fullført | [dato] |
| Arkitekturbeslutninger | Fullført | [dato] |
| Forretningsreferanser | Fullført | [dato] |
| Fri kontekst (valgfri) | [Lagt til / Hoppet over] | [dato] |
### Neste steg
@ -142,7 +168,7 @@ Pluginen er nå tilpasset din virksomhet. Prøv:
- Accept "vet ikke" / "usikker" as valid answers — note as "Ikke avklart"
- If user wants to skip a category, write the file with `completed: false` and note which questions were skipped
- Keep each phase focused — 2-3 questions, then write file and move on
- All 5 files are written DIRECTLY into the provided user-owned data directory (absolute path), never the plugin root
- All files (the 5 structured ones + the optional `free-context.md`) are written DIRECTLY into the provided user-owned data directory (absolute path), never the plugin root
## Error Handling

View file

@ -29,6 +29,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## Lokal KB-baseline (betinget — RAG / MLOps / engineering-temaer)

View file

@ -53,6 +53,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## 4 ekspertperspektiver

View file

@ -38,6 +38,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## Your Mission

View file

@ -44,6 +44,7 @@ Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten v
- `~/.claude/ms-ai-architect/org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `~/.claude/ms-ai-architect/org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `~/.claude/ms-ai-architect/org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
- `~/.claude/ms-ai-architect/org/free-context.md` — Fri kontekst (valgfri): alt annet virksomheten vil pluginen skal vite
## Output Format: Technical Summary