feat(ms-ai-architect): C2.1 onboarding skriver bruker-sti + 11-agent fallback + docs [skip-docs]
- 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:
parent
dc0b627e98
commit
466094f2a2
15 changed files with 118 additions and 89 deletions
|
|
@ -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`
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue