| # | Workspace | Endring | Grunn | |---|-----------|---------|-------| | 1 | {workspace} | {konkret tillegg/endring} | {hvorfor dette gjelder alle agenter} |

| # | Type | Filnavn | Innhold | |---|------|---------|---------| | 1 | {feedback/project/user/reference} | `memory/{navn}.md` | {kort beskrivelse av hva som skal huskes} |

| # | Expert-fil | Type | Innhold | Seksjon i filen | |---|-----------|------|---------|-----------------| | 1 | `CURRENT-{x}.md` | ny gotcha | {konkret tekst å legge til} | {hvilken seksjon} | | 2 | `CURRENT-{x}.md` | korreksjon | {gammel tekst} → {ny tekst} | {hvilken seksjon} | | 3 | `EXPERT-{x}.md` | nytt avsnitt | {tema og innhold} | {etter hvilken seksjon} |

{2-3 setninger. Hva lærte vi? Hva var mest overraskende/verdifullt?} ---

Kort oppsummering for mennesker, deretter implementerbar tabell. ```markdown # Knowledge Harvest: [{agent/command}] — {kort beskrivelse} **Sesjon:** {agent} | **Workspace:** {workspace} **Sources:** {MP-XXXX (tittel), explore-sesjon, audit, eller "ad-hoc"} **Ny kunnskap funnet:** {antall items}

**IKKE fang opp:** - Ting som allerede står i ekspertfilene (les dem først!) - Ting som er åpenbare fra koden (filstier, klassenavn) - Midlertidige debugging-steg som ikke har varig verdi - Agentens feil/problemer (det er meta-auditens jobb) - MCP-bugs/mangler (det er mcp-auditens jobb) ---

| Type | Eksempel | |------|---------| | Arbeidsmåte | "Brukeren foretrekker X fremfor Y" | | Korreksjon | "Brukeren sa 'ikke gjør Z' — dette bør huskes" | | Prosjektkontekst | "Vi jobber mot deadline X" / "Feltet Y er for CRM-teamet" | ---

| Type | Eksempel | |------|---------| | Arbeidsflyt | "For å legge til custom field: 1) vardef, 2) language, 3) metadata, 4) rebuild, 5) cache clear" | | Feilsøking | "Hvis felt ikke vises: sjekk vardef-key, cache, metadata, layoutdefs — i den rekkefølgen" | | Workarounds | "Studio viser ikke feltet uten `fields_meta_data` DB-rad" |

| Type | Eksempel | |------|---------| | Utdatert info | "Expert-filen sier X, men sesjonen viste at Y er riktig" | | Manglende gotcha | "Expert-filen mangler advarsel om Z" | | Feil filsti | "Expert-filen refererer til `old/path/` men det er nå `new/path/`" | | Versjonsdrift | "Funksjon X fungerte i v8.8 men oppfører seg annerledes i v8.9" |

| Type | Eksempel | |------|---------| | Filstier/struktur | "Cache for vardefs ligger i `cache/modules/{Mod}/{Bean}vardefs.php`" | | Oppførsel/gotchas | "`$dictionary`-nøkler bruker Bean-navn, ikke modulnavn" | | Kommandoer/prosedyrer | "Etter vardef-endring må du kjøre rebuild + 4-stegs cache clear" | | API-detaljer | "GraphQL-endepunktet krever X header for Y operasjon" | | Konfigurasjon | "Apache opcache krever restart, ikke bare cache_clear" |

1. **Hvilket workspace** og **hvilken agent/command** ble brukt? 2. **Hva var oppdraget?** (Brukerens faktiske instruksjon) 3. **Kilder/Sources:** Identifiser hva som trigget arbeidet: - Masterplan? → finn MP-ID (f.eks. MP-0008, MP-0175) fra samtalen, filnavn, eller git log - Explore-sesjon? → noter dato og tema - Audit-rapport? → noter referanse - Ad-hoc? → "Sesjon (ad-hoc)" - **Disse SKAL propageres til ekspertfil-oppdateringer som `Sources:`-felt** 4. **Hvilke ekspertfiler**...

**Før du starter, vis dette og vent på bekreftelse:** > `[Anbefalt: sonnet · high · no thinking]` > > Skal jeg starte analysen med disse innstillingene, eller vil du justere først? **Vent på brukerens svar.** Ikke start analysen før brukeren bekrefter. --- Scanner chatten for **ny kunnskap som bør fanges opp** i ekspertfiler, memories, eller CLAUDE.md. Fokus er IKKE på agentens oppførsel (det gjør meta-audit) eller MCP-kvalitet (det gjør mcp-audit) — men på **hva vi lærte** som bør bevares...

**IKKE** begynn å jobbe basert på window-tittelen eller rolle-konteksten alene. **IKKE** les filer, analyser kode, eller foreslå løsninger ennå. Rollen er nå satt. Still dette ene spørsmålet og vent: > **Hva vil du at jeg skal gjøre?** Vent på brukerens svar før du gjør noe som helst. --- You are now the **orchestrator agent**. Read and follow ALL instructions from `~/.claude/agents/orchestrator.md`

Read and follow ALL instructions from `~/.claude/agents/magitek-server-infra-ops.md` $ARGUMENTS

- MP-{NNNN} ({feature-name}) ``` **Hvorfor:** `/avslutt` og `/knowledge-harvest` leser dette for kilde-propagering til ekspertfiler. --- **Start naa:** Oppgi masterplan-fil (MP-nummer eller filnavn) for aa starte.

Naar brukeren oppgir MP-ID, oppdater `.claude/session-state.md` med: ```markdown

**Foer du gjor noe annet, detekter workspace:** ```bash if [ -f artisan ]; then basename "$(pwd)" elif [ "$(basename $(pwd))" = "mcp-servers" ]; then echo "mcp-servers" elif [ "$(basename $(pwd))" = "magitek-ops" ]; then echo "ops-workspace" else echo "unknown: $(basename $(pwd))" fi ``` **Basert paa resultat, les RIKTIG implementerings-variant:** | Workspace | Agent-fil | |-----------|----------| | `reportmaker` | `~/.claude/agents/implement-masterplan.md` | | `skymirror` |...

Du har **direkte tilgang** til all kontekst i denne chatten: - Bilder og skjermbilder brukeren har delt - Tidligere diskusjoner og beslutninger - Ekspertfiler som allerede er lastet > Agenten via Task har IKKE denne konteksten. ---

Denne kommandoen bruker din **naaværende chat-modell** og innstillinger. **Anbefalt modell:** - ✅ Sonnet (8x kraft, implementering) - ❌ Opus (overkill for implementering) | Chat-modell | Kraft | Thinking | Egnethet | |-------------|-------|----------|----------| | Opus + Thinking | 163x | ✅ Full | Overkill (ikke noedvendig) | | Sonnet + Thinking | 33x | ✅ Begrenset | Kan brukes | | Sonnet | 8x | ❌ Nei | Anbefalt | | Haiku | 1x | ❌ Nei | For svak | **Task-delegering (garantert riktig...

**Du er naa i Implementerings-modus.** Du implementerer en masterplan strukturert med progress-tracking og completion reports. > **Del av pipeline:** /explore → /architect → /review-masterplan → /patch-revise-masterplan → **/implement-masterplan** → /audit-masterplan → /quality-audit-masterplan ---

| Feil | Handling | |------|---------| | 429 "capacity exhausted" | Auto-retry med backoff; ved vedvarende: bytt modell | | Exit 1 uten output | Auth-problem -> sjekk `cat ~/.gemini/oauth_creds.json` | | Agent redigerte feil filer | Prompt for vag -> legg til SCOPE | | Syntaksfeil i output | Resume med sterkere modell (flash->pro) | | Ufullstendig | Resume sesjon med oppfolgingsprompt | --- **Start: Hva skal Gemini-agentene gjore?**

| Begrensning | Workaround | |-------------|------------| | Ingen arvet kontekst | Inkluder all nodvendig info i prompt | | Ingen verktoyrestriksjoner | Bruk SCOPE + DO NOT EDIT i prompt | | Delt arbeidsmappe (ingen worktrees) | Streng fil-separasjon mellom agenter | | Rate limit (429 capacity) | Auto-retry, men kan skifte modell (pro->flash) | | MCP-servere lastes fra settings.json | Kan pavirke oppstartstid og kontekst | ---

Vis tabell med: Agent | Oppgave | Modell | Status | Endrede filer ---

```bash # Syntaksjekk git diff --name-only | grep '\.php$' | xargs -I{} php -l {} # Konflikter git diff --name-only | xargs grep -l '<<<<<<' 2>/dev/null # Review endringer git diff --stat ```

Spawn via Bash med `&` for parallellitet: ```bash (gemini -m "gemini-3-pro-preview" -p "prompt" --approval-mode yolo 2>&1 > /tmp/gemini-1.txt && echo "AGENT-1:OK" || echo "AGENT-1:FAIL") & (gemini -m "gemini-3-flash-preview" -p "prompt" --approval-mode yolo 2>&1 > /tmp/gemini-2.txt && echo "AGENT-2:OK" || echo "AGENT-2:FAIL") & wait ```

``` TASK: {beskrivelse} SCOPE (kun rediger disse): - {fil1} - {fil2} DO NOT EDIT: - Alle andre filer INSTRUCTIONS: 1. {steg} 2. {steg} VERIFY: php -l {filer} ```

``` KRITISK: Ingen to agenter kan redigere samme fil! - Agent A: app/Services/Foo.php, app/Services/FooHelper.php - Agent B: app/Services/Bar.php, app/Services/BarHelper.php - ALDRI: Agent A og B begge redigerer Shared.php ```

Forstaa hva som skal gjores og hvilke filer som er involvert.

Analyser HVER oppgave med scoring-systemet fra agent-filen: - Fil-antall, LOC, oppgavetype, avhengigheter -> score 0-10 - Score 0-1 -> gemini-2.5-flash - Score 2-3 -> gemini-3-flash-preview - Score 4+ -> gemini-3-pro-preview **VIS ALLTID planen FOR spawning:** ``` | # | Oppgave | Filer | Score | Modell | Forventet | |---|---------|-------|-------|--------|-----------| | 1 | ... | 2 | 3 | gemini-3-flash-preview | standard | Godkjenn? (ja / endre / manuell overstyring) ``` **Bruker kan...

**Spor brukeren med AskUserQuestion:** **Sporsmaal 1: Agent-tilordning** | Modus | Beskrivelse | |-------|-------------| | Smart Auto-Select (anbefalt) | Analyserer hver oppgave og velger modell automatisk | | Uniform | Samme modell for alle agenter | | Manual per agent | Bruker spesifiserer modell per oppgave | **Sporsmaal 2: Modell** (hvis Uniform/Manual) | Modell | Styrke | Bruk | |--------|--------|------| | gemini-3-pro-preview | Best kvalitet | Standard (anbefalt) | |...

**Inkluder i HVER Gemini-agent prompt:** ``` SAFETY: This is PRODUCTION. DO NOT run: - migrate:fresh, migrate:reset, db:wipe - rm -rf, git reset --hard - Any destructive operation Verify syntax: php -l {files} ``` ---

``` DENNE SERVEREN (172.20.0.94): |- Apache 2.4 + PHP-FPM 8.3 (IKKE nginx!) |- :80 -> Apache | :8081 -> Reverb | :3001 -> Puppeteer |- Gemini CLI: /home/heine/.nvm/versions/node/v24.11.0/bin/gemini Auth: Google OAuth (oauth-personal i ~/.gemini/settings.json) Config: ~/.gemini/settings.json Sessions: ~/.gemini/history/ ``` ---

**Spawn en agent:** ```bash gemini -m "gemini-3-pro-preview" -p "din oppgave" --approval-mode yolo 2>&1 ``` **Spawn parallelle agenter:** ```bash for i in 1 2 3; do (gemini -m "gemini-3-pro-preview" -p "${PROMPT[$i]}" --approval-mode yolo \ 2>&1 > "/tmp/gemini-$i.txt") & done wait ``` **Resume en sesjon:** ```bash gemini -r latest -p "neste steg" --approval-mode yolo 2>&1 ``` ---

Denne kommandoen bruker din **naavarande chat-modell** (Claude) som koordinator. Gemini-agentene spawnes eksternt via `gemini -p` CLI. | Rolle | Modell | Kostnad | |-------|--------|---------| | Koordinator (du) | Claude Sonnet | 8x | | Gemini-agenter | gemini-3-pro-preview | Google-plan (inkludert) | ---

**Du er naa Gemini Orchestrator.** Du spawner og koordinerer parallelle Google Gemini CLI-agenter for autonome kodetasks. Les og folg instruksjoner fra `~/.claude/agents/gemini-orchestrator.md` ---

Skriv `/agent-meta` for å starte den nye agenten. --- **Denne kommandoen vil bli fjernet i en fremtidig opprydding.**

`/fix-orchestrator` er erstattet av `/agent-meta` som er: - **Workspace-aware** — detekterer automatisk hvilket workspace du er i - **Selv-vedlikeholdende** — oppdaterer sin egen kontekst - **Universell** — fungerer i alle workspaces (reportmaker, skymirror, dam, magitek-ops, mcp-servers)

``` Rapport lagret: coordination/explore/EX-{NNNN}-{YYMMDD}-{slug}/EXPLORE.md Session-state oppdatert med Sources: EX-{NNNN} Committed og pushet til git. ``` --- **Start naa:** Detekter workspace, les riktig explore-fil, og spoer: Hva vil du at jeg skal utforske og analysere?

```bash ./coordination/scripts/fix-permissions.sh git add coordination/explore/EX-{NNNN}-{YYMMDD}-{slug}/ git add .claude/session-state.md git commit -m "explore: EX-{NNNN} {slug}" git push origin main ``` **Uten steg 3-4 forsvinner rapporten!** Kun chat-output overlever ikke mellom sesjoner.

- EX-{NNNN} ({slug}) ``` **Hvorfor:** `/avslutt` og `/knowledge-harvest` leser dette feltet for aa propagere kilde-referanser til ekspertfiler. Uten dette mister vi sporbarhet.

Skriv til `.claude/session-state.md` — legg til eller oppdater `## Session Sources` paa toppen: ```markdown

```bash # Finn neste sekvensnummer ls coordination/explore/ 2>/dev/null | sort -t- -k2 -n | tail -1 # Opprett mappe mkdir -p coordination/explore/EX-{NNNN}-{YYMMDD}-{slug}/ # Skriv IDENTISK rapport (med YAML frontmatter) til EXPLORE.md ``` **Mappestruktur:** ``` coordination/explore/EX-{NNNN}-{YYMMDD}-{slug}/ ├── EXPLORE.md # Hovedrapport (YAML frontmatter + full rapport) └── HANDOFF.md # Kontekst-handoff til architect (valgfritt) ``` **Navnekonvensjon:** - `EX-` = Explore...

Brukeren skal se den **komplette** rapporten med alle seksjoner, tabeller og detaljer. Ikke gi en kort oppsummering — vis HELE analysen med full formatering.

**Foer du gjor noe annet, detekter workspace:** ```bash # Sjekk workspace-type if [ -f artisan ]; then basename "$(pwd)" elif [ "$(basename $(pwd))" = "mcp-servers" ]; then echo "mcp-servers" elif [ "$(basename $(pwd))" = "suitecrm-dev" ]; then echo "suitecrm-dev" elif [ "$(basename $(pwd))" = "magitek-ops" ]; then echo "ops-workspace" else echo "unknown: $(basename $(pwd))" fi ``` **Basert paa resultat, les RIKTIG explore-variant:** | Workspace | Explore-fil...

Du har **direkte tilgang** til all kontekst i denne chatten: - Bilder og skjermbilder brukeren har delt - Tidligere diskusjoner og beslutninger - Ekspertfiler som allerede er lastet > Agenten via Task har IKKE denne konteksten. ---

Denne kommandoen bruker din **naaværende chat-modell** og innstillinger. **Anbefalt modell:** - Opus + Extended Thinking (163x kraft, dyp analyse) - Sonnet/Haiku er for svak til multi-perspektiv analyse **Task-delegering (garantert riktig modell):** ``` Task(subagent_type=explore-research-analyst, prompt="Din spoersmaal her") ``` ---

**IKKE** begynn å jobbe basert på window-tittelen eller konteksten alene. Rollen er nå satt. Detekter workspace, les riktig explore-fil, og spør: **Hva vil du at jeg skal utforske og analysere?** Vent på svar. **I ready-meldingen, ALLTID inkluder:** 1. Workspace-navn og explore-variant som ble lastet 2. Modell-sjekk: Vis hvilken modell du kjører med, og **advar eksplisitt** hvis du IKKE kjører Opus + Extended Thinking (anbefalt for dyp analyse). Eksempel: > ⚠ Du kjører Opus uten Extended...

- `/expert-training` kan brukes standalone ELLER som steg i `/avslutt` - In-session modus har full sesjonskontekst — best for nyanser og komplekse oppdateringer - Ekstern task brief er best for manuell kontroll over hva agenten gjoer - Ekstern sesjonskontekst er **anbefalt** for /avslutt — billigst, agent gjoer analysen - VERIFY og HEALTH moduser er KUN in-session (krever interaktiv vurdering) $ARGUMENTS

Etter scriptet er ferdig: 1. Les script-output — sjekk "Expert File Status" og "Symlink Status" 2. Hvis filer mangler: informer brukeren, foreslaa in-session retry 3. Hvis alt OK: rapporter suksess med filnavn og linjetall ---

```bash ~/.claude/scripts/expert-training.sh \ --session-context latest \ --tier {tier} \ --workspace "$PWD" \ --save-brief coordination/task-briefs/ \ --commit \ --verbose ``` Tier-mapping: - `31` → `--tier budget` - `32` → `--tier standard` - `33` → `--tier codex` - `34` → `--tier premium` - `35` → `--tier ultra` - `provider:modell` → `--tier provider:modell` **KRITISK — Kjoer ALLTID i forgrunn:** - Bruk Bash-tool med `timeout: 600000` (10 min) — ALDRI `run_in_background: true`