open/ms-ai-architect
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions

feat(ms-ai-architect): C2.1 onboarding skriver bruker-sti + 11-agent fallback + docs [skip-docs]

Browse source 
- onboard.md (orkestrator): resolver absolutt $ORG_DIR via Bash + mkdir -p, gir
  agenten stien. allowed-tools +Bash. Status/resume globber bruker-sti.
- onboarding-agent.md: skriver de 5 org-filene til den absolutte bruker-stien
  (~/.claude/ms-ai-architect/org/), aldri plugin-rot.
- 11 org-bevisste agenter: uniform Virksomhetskontekst-blokk -> bruker-sti +
  note om ambient injeksjon + subagent-fallback (grep-verifisert 11/11).
  Risiko 1 BEVIST: Task-subagent arver IKKE SessionStart-injeksjon; Read/Glob
  ekspanderer ~ -> fallback lesbar uten Bash.
- README + plan: sti-referanse + C2.1-resultat. CLAUDE.md uendret (ingen sti-ref).

Verifisert: validate PASSED · kb-integrity 192/192 · discovery 13/13.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-06-22 13:34:19 +02:00
commit 466094f2a2
15 changed files with 118 additions and 89 deletions
Download patch file Download diff file Expand all files Collapse all files

2
README.md
View file

@ -170,7 +170,7 @@ The plugin delegates specialized work to 12 purpose-built agents. Each agent has
| `license-mapper-agent` | Cross-reference licenses vs. platform capabilities | ms-ai-advisor | `/architect:license` |
| `diagram-generation-agent` | Architecture diagrams via Imagen 3 / Mermaid | Prompt templates | `/architect:diagram` |
| `summary-agent` | Executive summary and decision memo synthesis | All assessment outputs (incl. ROS) | `/architect:summary` |
| `onboarding-agent` | 5-phase structured org interview | Writes org/*.md | `/architect:onboard` |
| `onboarding-agent` | 5-phase structured org interview | Writes ~/.claude/ms-ai-architect/org/*.md (user-owned, survives reinstall) | `/architect:onboard` |
| `ai-act-assessor` | EU AI Act classification, obligations, and compliance assessment | ms-ai-governance (ai-act-*) | `/architect:classify`, `/architect:requirements`, `/architect:transparency`, `/architect:frimpact`, `/architect:conformity` |
### Orchestration Pattern

12
agents/adr-writer-agent.md
View file

@ -28,12 +28,12 @@ Generate complete, self-contained ADR documents that:
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## Process

12
agents/ai-act-assessor.md
View file

@ -37,12 +37,12 @@ Read relevant files from:
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## Assessment Workflow (6 faser)

12
agents/architecture-review-agent.md
View file

@ -174,12 +174,12 @@ Load domain-specific references only when dimension requires depth (max 2-3 addi
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
### 3. Validate Against Latest Guidance
Use `microsoft_docs_search` to verify:

12
agents/cost-estimation-agent.md
View file

@ -66,12 +66,12 @@ Load additional files only when estimate requires specific depth:
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
### 4. Verify Current Pricing

12
agents/diagram-generation-agent.md
View file

@ -23,12 +23,12 @@ Du er en spesialisert diagramgenerator for Microsoft AI-arkitekturer. Du lager p
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## Diagramtyper

12
agents/dpia-agent.md
View file

@ -29,12 +29,12 @@ Load additional files only when assessment requires specific depth:
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## AI Act-integrasjon

12
agents/license-mapper-agent.md
View file

@ -20,12 +20,12 @@ You are a Microsoft licensing specialist that maps licenses to AI capabilities a
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## Your Mission

25
agents/onboarding-agent.md
View file

@ -2,7 +2,8 @@
name: onboarding-agent
description: |
Conducts structured 5-category onboarding interview to collect org-specific context.
Writes context files to org/ directory for use by all other agents and commands.
Writes context files to the user-owned ~/.claude/ms-ai-architect/org/ directory
(survives plugin reinstall) for use by all other agents and commands.
Triggers on: onboarding, virksomhetstilpasning, architect:onboard command.
model: opus
color: cyan
@ -11,17 +12,21 @@ 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 `org/` files 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 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
**VIKTIG:** Bruk norske tegn (æ, ø, å) korrekt i all output. Skriv på norsk med engelske fagtermer der det er naturlig. Aldri erstatt æ med ae, ø med o, eller å med a.
## Datakatalog (bruker-eid — bruk den absolutte stien du får i prompten)
Orkestratoren (`/architect:onboard`) gir deg en **absolutt** datakatalog (`~/.claude/ms-ai-architect/org/` resolvet til full sti). Bruk DEN for ALL Glob/Read/Write — aldri plugin-roten. Katalogen er bruker-eid og overlever plugin-reinstall. Filnavnene under (`organization-profile.md` osv.) ligger DIREKTE i denne katalogen. Hvis prompten ikke ga en sti, bruk `~/.claude/ms-ai-architect/org/`.
## Resume Logic
On start, check for existing onboarding state:
1. Use Glob to check if `org/` directory exists and which files are present
1. Use Glob on the provided data directory to see which of the 5 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
@ -41,7 +46,7 @@ Collect:
- *Offentlig sektor:* Use AskUserQuestion with multiSelect: Personopplysningsloven/GDPR, Sikkerhetsloven, Arkivloven, Forvaltningsloven, Offentleglova, Helseregisterloven, Annet
- *Privat sektor:* Use AskUserQuestion with multiSelect: Personopplysningsloven/GDPR, DORA (finans), Finansforetaksloven, Finanstilsynets IKT-forskrift, Verdipapirhandelloven, Hvitvaskingsloven, Sikkerhetsloven (kritisk infrastruktur), Annet
After answers, write `org/organization-profile.md`:
After answers, write `organization-profile.md` to the data directory:
```markdown
---
@ -75,7 +80,7 @@ Collect:
- **Lisenstype:** Use AskUserQuestion with options: E3, E5, F1/F3, A3/A5 (Education), G3/G5 (Government), Annet
- **AI-tjenester i bruk:** Use AskUserQuestion with multiSelect: Azure OpenAI, Copilot for Microsoft 365, Copilot Studio, AI Builder, Azure AI Search, Azure AI Services, Ingen i dag, Annet
After answers, write `org/technology-stack.md` with same YAML frontmatter pattern.
After answers, write `technology-stack.md` to the data directory with same YAML frontmatter pattern.
### Phase 3: Security & Compliance (`org/security-compliance.md`)
@ -85,7 +90,7 @@ Collect:
- **DPIA-praksis:** Use AskUserQuestion with options: Systematisk for alle AI-prosjekter, Ad hoc ved behov, Ikke etablert, Usikker
- **Sertifiseringer/rammeverk:** Fritekst (NSM Grunnprinsipper, ISO 27001, SOC 2, etc.)
After answers, write `org/security-compliance.md`.
After answers, write `security-compliance.md` to the data directory.
### Phase 4: Architecture Decisions (`org/architecture-decisions.md`)
@ -94,7 +99,7 @@ Collect:
- **Integrasjonsbehov:** Use AskUserQuestion with multiSelect: Microsoft 365, SharePoint, Dynamics 365, SAP, Fagsystemer, REST API-er, Annet
- **Budsjettramme for AI-initiativer (årlig):** Use AskUserQuestion with options: <500k NOK, 500k-2M NOK, 2M-10M NOK, >10M NOK, Ikke definert
After answers, write `org/architecture-decisions.md`.
After answers, write `architecture-decisions.md` to the data directory.
### Phase 5: Business References (`org/business-references.md`)
@ -103,7 +108,7 @@ Collect:
- **Dokumentformat-preferanser:** Use AskUserQuestion with multiSelect: Markdown, Word (.docx), PDF, Confluence, SharePoint Wiki, Annet
- **Referansearkitektur:** Fritekst — har virksomheten en eksisterende referansearkitektur eller strategidokumenter for AI?
After answers, write `org/business-references.md`.
After answers, write `business-references.md` to the data directory.
## Completion Report
@ -137,11 +142,11 @@ 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 org/ files use relative paths from plugin root
- All 5 files are written DIRECTLY into the provided user-owned data directory (absolute path), never the plugin root
## Error Handling
- If Write fails, inform user and suggest creating `org/` directory manually
- If Write fails, inform user and suggest creating the data directory manually (`mkdir -p ~/.claude/ms-ai-architect/org`)
- If AskUserQuestion returns empty, prompt again with simpler options
- If user aborts mid-interview, write partial files with `completed: false`

12
agents/research-agent.md
View file

@ -23,12 +23,12 @@ Du er en spesialisert Microsoft AI-forsker. Din oppgave er å samle presis, oppd
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## Lokal KB-baseline (betinget — RAG / MLOps / engineering-temaer)

12
agents/ros-analysis-agent.md
View file

@ -47,12 +47,12 @@ Alle stier under `skills/ms-ai-governance/references/norwegian-public-sector-gov
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## 4 ekspertperspektiver

12
agents/security-assessment-agent.md
View file

@ -32,12 +32,12 @@ Load additional files only when assessment requires specific depth:
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## Your Mission

12
agents/summary-agent.md
View file

@ -38,12 +38,12 @@ Look for these assessment outputs in conversation history or files:
## Virksomhetskontekst (automatisk)
Hvis `org/`-mappen finnes, les relevante filer for å tilpasse vurderingen:
- `org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `org/security-compliance.md` — Dataklassifisering, policyer, godkjenning
- `org/architecture-decisions.md` — ADR-er, retningslinjer, preferanser, budsjett
- `org/business-references.md` — Maler, styringsmodell, nøkkelpersonell
Et kompakt sammendrag av virksomhetskonteksten injiseres ambient i hovedøkten ved sesjonsstart. **Som Task-spawnet subagent arver du normalt IKKE den injeksjonen** (verifisert) — les derfor filene direkte fra den **bruker-eide** katalogen `~/.claude/ms-ai-architect/org/` (overlever plugin-reinstall; `~` ekspanderes av Read/Glob). Har du allerede sammendraget i konteksten, bruk det og hopp over lesingen:
- `~/.claude/ms-ai-architect/org/organization-profile.md` — Virksomhet, sektor, regulatoriske krav
- `~/.claude/ms-ai-architect/org/technology-stack.md` — Cloud, lisenser, eksisterende AI
- `~/.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
## Output Format: Technical Summary

37
commands/onboard.md
View file

@ -2,7 +2,7 @@
name: architect:onboard
description: Onboard pluginen med virksomhetsspesifikk kontekst
argument-hint: "[--status]"
allowed-tools: Read, Glob, Grep, Task, Write, AskUserQuestion
allowed-tools: Read, Glob, Grep, Task, Write, AskUserQuestion, Bash
model: opus
---
@ -14,11 +14,23 @@ Du er Cosmo Skyberg, og skal starte onboarding-prosessen for å tilpasse plugine
**VIKTIG:** Bruk norske tegn (æ, ø, å) korrekt i all output.
## Datakatalog (bruker-eid — løses FØR alt annet)
Virksomhetskonteksten lagres i en **bruker-eid** katalog som overlever plugin-reinstall (ikke i plugin-roten, som blåses bort ved oppgradering). Resolv den absolutte stien én gang og bruk den for ALL lesing/skriving under:
```bash
ORG_DIR="$HOME/.claude/ms-ai-architect/org"
mkdir -p "$ORG_DIR"
echo "$ORG_DIR"
```
Bruk den utskrevne absolutte stien (`$ORG_DIR`) i alle Glob/Read/Write-kall og i Task-prompten til onboarding-agenten. **Skriv aldri org-filer til plugin-roten.** (Stien speiler `lib/user-data.mjs` `resolveOrgDir`, som bruker `os.homedir()`.)
## Statussjekk (--status)
Hvis argumentet inneholder `--status`:
1. Bruk Glob for å finne alle `org/*.md`-filer
1. Bruk Glob for å finne alle `$ORG_DIR/*.md`-filer (absolutt bruker-eid sti)
2. Les hver fil og sjekk frontmatter (`completed: true/false`, `last_updated`)
3. Vis statusrapport:
@ -27,13 +39,13 @@ Hvis argumentet inneholder `--status`:
| Kategori | Fil | Status | Oppdatert |
|----------|-----|--------|-----------|
| Virksomhetsprofil | org/organization-profile.md | [Fullført/Mangler] | [dato] |
| Teknologistack | org/technology-stack.md | [Fullført/Mangler] | [dato] |
| Sikkerhet og compliance | org/security-compliance.md | [Fullført/Mangler] | [dato] |
| Arkitekturbeslutninger | org/architecture-decisions.md | [Fullført/Mangler] | [dato] |
| Forretningsreferanser | org/business-references.md | [Fullført/Mangler] | [dato] |
| Virksomhetsprofil | organization-profile.md | [Fullført/Mangler] | [dato] |
| Teknologistack | technology-stack.md | [Fullført/Mangler] | [dato] |
| Sikkerhet og compliance | security-compliance.md | [Fullført/Mangler] | [dato] |
| Arkitekturbeslutninger | architecture-decisions.md | [Fullført/Mangler] | [dato] |
| Forretningsreferanser | business-references.md | [Fullført/Mangler] | [dato] |
**Fullført:** X/5 kategorier (XX%)
**Fullført:** X/5 kategorier (XX%) — lagret i `$ORG_DIR`
```
4. Hvis noen mangler, tilby å kjøre `/architect:onboard` for å fullføre
@ -41,7 +53,7 @@ Hvis argumentet inneholder `--status`:
## Ingen onboarding
Hvis `org/`-mappen ikke finnes og ingen `--status`-flagg:
Hvis `$ORG_DIR` er tom (ingen `.md`-filer) og ingen `--status`-flagg:
Vis:
```
@ -60,17 +72,18 @@ Deretter start onboarding-agenten (se under).
## Start/gjenoppta onboarding
Sjekk eksisterende `org/`-filer for å avgjøre resume-punkt:
Sjekk eksisterende `$ORG_DIR/*.md`-filer for å avgjøre resume-punkt:
```
Task(architect:onboarding-agent): "Read agents/onboarding-agent.md for your role and instructions.
Gjennomfør onboarding-intervju for å samle virksomhetsspesifikk kontekst.
Datakatalog (absolutt, bruker-eid): <$ORG_DIR fra Datakatalog-steget>
Eksisterende org-filer: [list files that exist, or 'ingen']
Skriv resultater til org/-mappen under plugin-roten. Kjør alle 5 faser i rekkefølge,
hopp over kategorier som allerede har completed: true."
Skriv resultater til denne absolutte katalogen (IKKE plugin-roten). Kjør alle 5 faser i
rekkefølge, hopp over kategorier som allerede har completed: true."
```
## Etter fullført onboarding

11
docs/onboarding-redesign-plan.md
View file

@ -121,3 +121,14 @@ C2.1 er den bærende delsesjonen (etablerer lagring + resolver alle andre bygger
8. **Avslutt:** `validate` 239 + nye enhetstester + `test-hooks.sh` grønne · commit per logisk enhet · push (vindu 20–23 hverdag) · oppdater STATE (C2.2 neste) + denne planen (C2.1-resultater).
**Ikke i C2.1:** fritekst-felt (C2.2), scheduler-spørsmål i onboarding (C2.3), §167-verifisering (C2.4).
### C2.1 — RESULTAT (levert, TDD test FØR kode)
- **`lib/user-data.mjs` (NY, ren, SKRIVER ALDRI; kun `node:os/path`):** `resolveUserDataDir/resolveOrgDir/resolveConfigPath` (peker `~/.claude/ms-ai-architect/`, uavhengig av `pluginRoot` → **K2**), `CONFIG_FILENAME` (delt med C1, én sannhetskilde), `ORG_FILES`, `buildOrgSummary(orgFiles,{cap,maxValueLen})` (generisk H2-ekstraksjon, frontmatter+H1-stripp, deterministisk ORG_FILES-rekkefølge, lengde-kapp ~25 l + per-felt-trim).
- **`detection-schedule.mjs` bakoverkompat:** `loadScheduleConfig(pluginRoot, home=homedir())` leser bruker-sti FØRST, fallback plugin-rot. Lokal `CONFIG_FILENAME` fjernet → importeres fra resolver. Alle 3 kallere (hook, run-detection, scheduler) bruker ett-arg-kall → uendret oppførsel.
- **`session-start-context.mjs` ambient (K1):** resolver bruker-org-dir (fallback plugin `org/`), leser filene, injiserer `buildOrgSummary` som egen «Virksomhetskontekst (auto-injisert …)»-blokk. Status-nudge beholdt når org tom.
- **Skriving:** `onboard.md` (orkestrator) resolver absolutt `$ORG_DIR` via Bash + `mkdir -p` og gir agenten den; `onboarding-agent.md` skriver til den absolutte bruker-stien (ikke plugin-rot).
- **11 agenter:** uniform «Virksomhetskontekst»-blokk → bruker-sti + note om ambient + subagent-fallback (grep-verifisert 11/11).
- **Risiko 1 BEVIST:** Task-spawnet subagent arver **IKKE** SessionStart-injeksjonen (live-probe) → agentene bæres av fallback-fil-lesing; `Read`/`Glob` ekspanderer `~` (verifisert) → bruker-sti lesbar uten Bash.
- **Verifisert:** user-data 16/16 · detection-schedule 23/23 (+2 round-trip) · test-hooks 10/10 (+4: K1-injeksjon + tom-org-negativ) · kb-update 191 · kb-eval 100 · validate PASSED (0/0) · kb-integrity 192/192 (220 baseline-warns) · discovery 13/13 · gitleaks 3 PRE-EKSISTERENDE (`playground/vendor/`). CLAUDE.md trengte ingen sti-endring (kun kommando/agent-omtale); `.gitignore org/` beholdt som forsvar-i-dybden.
- **Neste:** C2.2 (fritekst-felt `org/free-context.md` → fanges av onboarding + inkluderes kappet i `buildOrgSummary`).