diff --git a/README.md b/README.md index 6af1a2c..22093bb 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/agents/adr-writer-agent.md b/agents/adr-writer-agent.md index 76912b1..d4f5abe 100644 --- a/agents/adr-writer-agent.md +++ b/agents/adr-writer-agent.md @@ -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 diff --git a/agents/ai-act-assessor.md b/agents/ai-act-assessor.md index b5240cb..514e91f 100644 --- a/agents/ai-act-assessor.md +++ b/agents/ai-act-assessor.md @@ -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) diff --git a/agents/architecture-review-agent.md b/agents/architecture-review-agent.md index edefa52..e923d74 100644 --- a/agents/architecture-review-agent.md +++ b/agents/architecture-review-agent.md @@ -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: diff --git a/agents/cost-estimation-agent.md b/agents/cost-estimation-agent.md index 7458e10..4f3eddd 100644 --- a/agents/cost-estimation-agent.md +++ b/agents/cost-estimation-agent.md @@ -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 diff --git a/agents/diagram-generation-agent.md b/agents/diagram-generation-agent.md index 1202d73..93dbc41 100644 --- a/agents/diagram-generation-agent.md +++ b/agents/diagram-generation-agent.md @@ -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 diff --git a/agents/dpia-agent.md b/agents/dpia-agent.md index eeee58b..41cec97 100644 --- a/agents/dpia-agent.md +++ b/agents/dpia-agent.md @@ -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 diff --git a/agents/license-mapper-agent.md b/agents/license-mapper-agent.md index 6f70a82..f7dc6b5 100644 --- a/agents/license-mapper-agent.md +++ b/agents/license-mapper-agent.md @@ -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 diff --git a/agents/onboarding-agent.md b/agents/onboarding-agent.md index 69c201c..226e243 100644 --- a/agents/onboarding-agent.md +++ b/agents/onboarding-agent.md @@ -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` diff --git a/agents/research-agent.md b/agents/research-agent.md index e97d461..7a2012b 100644 --- a/agents/research-agent.md +++ b/agents/research-agent.md @@ -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) diff --git a/agents/ros-analysis-agent.md b/agents/ros-analysis-agent.md index 199019a..2efaaaa 100644 --- a/agents/ros-analysis-agent.md +++ b/agents/ros-analysis-agent.md @@ -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 diff --git a/agents/security-assessment-agent.md b/agents/security-assessment-agent.md index ca0b10a..fd84dca 100644 --- a/agents/security-assessment-agent.md +++ b/agents/security-assessment-agent.md @@ -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 diff --git a/agents/summary-agent.md b/agents/summary-agent.md index 3865c40..dc295f9 100644 --- a/agents/summary-agent.md +++ b/agents/summary-agent.md @@ -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 diff --git a/commands/onboard.md b/commands/onboard.md index 0cf03d1..1fa6170 100644 --- a/commands/onboard.md +++ b/commands/onboard.md @@ -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 diff --git a/docs/onboarding-redesign-plan.md b/docs/onboarding-redesign-plan.md index b659f29..d47d289 100644 --- a/docs/onboarding-redesign-plan.md +++ b/docs/onboarding-redesign-plan.md @@ -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`).