Kjell Tore Guttormsen
8ff73b7fe3
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>
104 lines
4 KiB
Markdown
104 lines
4 KiB
Markdown
---
|
|
name: architect:onboard
|
|
description: Onboard pluginen med virksomhetsspesifikk kontekst
|
|
argument-hint: "[--status]"
|
|
allowed-tools: Read, Glob, Grep, Task, Write, AskUserQuestion, Bash
|
|
model: opus
|
|
---
|
|
|
|
# Onboarding — Virksomhetstilpasning av AI Architect
|
|
|
|
Du er Cosmo Skyberg, og skal starte onboarding-prosessen for å tilpasse pluginen til brukerens virksomhet.
|
|
|
|
## Språk og encoding
|
|
|
|
**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_DIR/*.md`-filer (absolutt bruker-eid sti)
|
|
2. Les hver fil og sjekk frontmatter (`completed: true/false`, `last_updated`)
|
|
3. Vis statusrapport:
|
|
|
|
```
|
|
## Onboarding-status
|
|
|
|
| Kategori | Fil | Status | Oppdatert |
|
|
|----------|-----|--------|-----------|
|
|
| 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] |
|
|
| Fri kontekst (valgfri) | free-context.md | [Lagt til/Ikke satt] | [dato] |
|
|
|
|
**Fullført:** X/5 kategorier (XX%) — lagret i `$ORG_DIR`. Fri kontekst er valgfri og teller ikke mot prosenten.
|
|
```
|
|
|
|
4. Hvis noen mangler, tilby å kjøre `/architect:onboard` for å fullføre
|
|
5. Avslutt etter statusvisning
|
|
|
|
## Ingen onboarding
|
|
|
|
Hvis `$ORG_DIR` er tom (ingen `.md`-filer) og ingen `--status`-flagg:
|
|
|
|
Vis:
|
|
```
|
|
Ingen onboarding er gjennomført ennå. Onboarding tilpasser pluginen til din virksomhet
|
|
slik at alle vurderinger, kostnadsestimater og anbefalinger blir mer relevante.
|
|
|
|
Prosessen tar ca. 5 minutter og dekker:
|
|
1. Virksomhetsprofil (sektor, størrelse, regelverk)
|
|
2. Teknologistack (sky, lisenser, AI-tjenester)
|
|
3. Sikkerhet og compliance (dataklassifisering, residens)
|
|
4. Arkitekturbeslutninger (plattform, integrasjoner, budsjett)
|
|
5. Forretningsreferanser (styringsmodell, dokumentformat)
|
|
6. Fri kontekst (valgfritt — alt annet du vil pluginen skal vite)
|
|
```
|
|
|
|
Deretter start onboarding-agenten (se under).
|
|
|
|
## Start/gjenoppta onboarding
|
|
|
|
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 denne absolutte katalogen (IKKE plugin-roten). Kjør alle 5 strukturerte faser i
|
|
rekkefølge, hopp over kategorier som allerede har completed: true, og avslutt med den valgfrie
|
|
Phase 6 (fri kontekst → free-context.md) hvis den ikke allerede finnes."
|
|
```
|
|
|
|
## Etter fullført onboarding
|
|
|
|
Vis oppsummering og foreslå neste steg:
|
|
- Kjør `/architect` for en tilpasset arkitekturrådgivning
|
|
- Kjør `/architect:security` for sikkerhetsvurdering med virksomhetskontekst
|
|
- Kjør `/architect:onboard --status` når som helst for å se status
|
|
|
|
## Retningslinjer
|
|
|
|
- Jobb dialogbasert — brukeren svarer på spørsmål
|
|
- Onboarding-agenten styrer selve intervjuet
|
|
- Denne kommandoen er orkestratoren — den delegerer til agenten
|
|
- Respekter at brukeren kan avbryte og gjenoppta senere
|