| # | Server | Tool | Nåværende begrensning | Foreslått forbedring | Prioritet | |---|--------|------|-----------------------|---------------------|-----------| | 1 | `{server}` | `{tool_name}` | {hva som mangler} | {konkret forbedring} | {høy/middels/lav} |

| # | Server | Behov | Workaround agenten brukte | Foreslått tool/endring | Prioritet | |---|--------|-------|--------------------------|----------------------|-----------| | 1 | `{server}` | {hva agenten trengte} | {SSH/bash/multi-kall} | {nytt tool eller parameter} | {høy/middels/lav} |

| # | Server | Tool | Problem | Forventet oppførsel | Alvorlighet | |---|--------|------|---------|---------------------|-------------| | 1 | `{server}` | `{tool_name}` | {hva skjedde} | {hva som burde skjedd} | {KRITISK/HØY/MIDDELS/LAV} |

{3-5 setninger. Hvor godt fungerte MCP-serveren(e)? Hva tvang agenten til workarounds? Hovedfunn.} ---

```markdown # MCP-Audit: [{agent/command}] — {kort beskrivelse} **Sesjon:** {agent} | **Workspace:** {workspace} **Egenbygde MCP-servere i bruk:** {liste} **MCP-kall totalt:** {antall} | **MCP-feil:** {antall} | **SSH/bash-fallbacks:** {antall}

| Sjekk | Detalj | |-------|--------| | Nye tools | Hvilke nye tools ville gjort agentens arbeid enklere? | | Tool-forbedringer | Hvilke eksisterende tools trenger bedre output/parametre? | | Bedre feilmeldinger | Hvor ville klarere feilmeldinger spart tid? | | Dokumentasjon | Manglet agenten forståelse av tool-oppførsel (indikerer dårlig tool-description)? | | Performance | Var noen tools trege der de burde vært raske? | ---

| Sjekk | Detalj | |-------|--------| | SSH/bash-workaround | Agenten brukte SSH/bash fordi MCP ikke støttet operasjonen | | Multi-kall workaround | Agenten måtte gjøre N kall der 1 burde holdt | | Parse-workaround | Agenten måtte parse/transformere MCP-output manuelt | | Feilhåndtering-workaround | Agenten måtte gjette årsak til MCP-feil fordi feilmeldingen var uklar | | Redundant kall | Agenten kalte samme tool flere ganger fordi output var utilstrekkelig |

| Sjekk | Detalj | |-------|--------| | SSH/bash-fallback | Hvor brukte agenten SSH/bash for noe MCP burde håndtert? | | Manglende tool | Trengte agenten en operasjon som ikke finnes som MCP-tool? | | Manglende parametere | Hadde et eksisterende tool for lite fleksibilitet/parametre? | | Manglende filtrering | Kunne ikke agenten filtrere/søke godt nok via MCP? | | Manglende batch | Måtte agenten gjøre mange enkeltkall der batch-operasjon ville vært bedre? | | Manglende kontekst | Returnerte...

| Sjekk | Detalj | |-------|--------| | Feil returndata | Returnerte et tool feil data, manglende felter, eller uventet format? | | Timeouts | Tok noen kall urimelig lang tid eller timet ut? | | Feilmeldinger | Ga tools kryptiske eller lite hjelpsomme feilmeldinger? | | Stille feil | Returnerte et tool "suksess" men med feil/ufullstendig resultat? | | Parameterfeil | Godtok et tool feil parametere uten feilmelding, eller avviste gyldige? | | API-feil under | Feilet underliggende API via MCP? |

1. **Hvilke egenbygde MCP-servere** ble brukt i sesjonen? (filtrer bort tredjepart) 2. **Hvilke MCP-tools ble kalt** for disse serverne? (list opp alle `mcp__{server}__*` kall) 3. **Hvilke MCP-tools feilet** eller ga uventede resultater? 4. **Hvor falt agenten tilbake til SSH/bash/grep** for noe MCP burde dekket? 5. **Hvilke operasjoner manglet MCP-tool for** — agenten måtte bruke workarounds? ---

Identifiser hvilke **egenbygde MCP-servere** som ble brukt i sesjonen, basert på `mcp__*` kall i chatten. **Egenbygde MCP-servere (vår kode):** | MCP-server | Pakke | Brukes i workspaces | |------------|-------|---------------------| | `suitecrm` | `packages/mcp-suitecrm/` | suitecrm-dev, magitek-ops | > Denne tabellen oppdateres etter hvert som vi bygger flere servere. > Hvis sesjonen bruker en MCP-server som IKKE er i tabellen, er den tredjepart og utenfor scope. **For hver egenbygd...

**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. --- Gjennomfør en grundig analyse av chatten/sesjonen med fokus på **egenbygde MCP-serveres oppførsel, mangler og utviklingsmuligheter**. Du er IKKE her for å vurdere agenten — du er her for å vurdere MCP-serveren(e). > **Scope:** Kun...

Denne kommandoen er splittet i to: - **`/prompt-agent-chat-mcp-selfbuild`** — Kodekvalitet for egenbygde MCP-servere (bugs, gaps, features) - **`/prompt-agent-chat-mcp-usage-audit`** — Agentens utnyttelse av ALLE MCP-servere (bruk, feilbruk, sløsing) Kjør den som passer for ditt behov.

**Steg 1 — Vis hele rapporten i chat.** IKKE forkort, avkort, eller oppsummer. Brukeren skal kunne lese alt uten å åpne filen. Vis hele markdown-rapporten direkte i chat-svaret. **Steg 2 — Lagre til fil.** Etter at rapporten er vist i chat, lagre den OGSÅ til fil: **Sti:** `coordination/maintenance/audits/knowledge/HARVEST-{YYYY-MM-DD}-{kort-slug}.md` - `{kort-slug}` = 2-4 ord som beskriver sesjonen (f.eks. "lead-navn-synk-hooks") - Opprett mappene hvis de ikke finnes (`mkdir -p`) - Bruk...

- **Les ekspertfilene FØRST.** Ikke foreslå å legge til noe som allerede finnes. - **Kun varig kunnskap.** Sesjons-spesifikke detaljer hører ikke hjemme i ekspertfiler. - **Konkret tekst.** Ikke si "legg til info om X" — skriv den faktiske teksten som skal legges inn. - **Riktig fil.** Plasser kunnskap i den mest relevante ekspertfilen, ikke bare den første du finner. - **Sources-propagering.** Når du foreslår ekspertfil-oppdateringer, ALLTID inkluder `**Sources:**`-felt med MP-ID,...

Oppsummer alle funn i én setning og spør: > Jeg oppdaterer sak {#, #, ...} direkte (ekspertfiler/memories/CLAUDE.md). **OK?** Utelat kategorier der det ikke er noen saker. Vent på brukerens "ja" før du gjør noe. **Ved "ja":** Oppdater ALLE saker i tabellen. Ikke filtrer basert på viktighet. Ikke hopp over entries du mener er "for trivielle". Alt i tabellen utføres. **KRITISK REGEL: Auditor filtrerer IKKE. Alle funn i "Kunnskap å fange opp"-tabellene SKAL utføres. Tabellen er...

Hvis du ikke finner ny kunnskap: "Ingen ny kunnskap å fange opp. Alt som ble lært i sesjonen er allerede dekket av eksisterende ekspertfiler og memories." ---

| # | 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 ``` ---