Kjor AUTOMATISK via sesjonskontekst (ekstern Codex-agent): ```bash ~/.claude/scripts/expert-training.sh \ --session-context latest \ --tier codex \ --workspace "$PWD" \ --save-brief coordination/task-briefs/ \ --commit \ --verbose ``` Hardkodet til Codex (GPT-5.4) — grundig analyse, gratis kapasitet. Scriptet: 1. Ekstraherer kompakt sesjonskontekst fra JSONL-loggen (~10K tokens) 2. Sender konteksten til ekstern agent 3. Agenten analyserer sesjonen og oppdaterer ekspertfiler...

Etter modellbekreftelse kjores ALLTID full modus: - Steg 1+3 PARALLELT (ekspertfiler + session-audit) → steg 2 (memories) → steg 4 (commit + push) **PARALLELLISERING:** Steg 1 (expert-training via Codex) og steg 3 (session-audit via Copilot) er uavhengige eksterne agenter. Start begge AUTOMATISK og PARALLELT: 1. Start begge Bash-kommandoene med `run_in_background: true` 2. Vent paa begge 3. Fortsett med memories (steg 2) og presentasjon (steg 3b) **INGEN menyer eller bekreftelse — bare kjor.**

**Anbefalt: Opus · low · no thinking** Denne kommandoen er mekanisk (git status, commit, push) men krever nok intelligens for menynavigasjon og rapport-presentasjon. Haiku er for svak og fyller kontekstvinduet. Expert-training/session-audit-arbeidet delegeres til eksterne agenter. **Spor brukeren na:** > Du kjorer `/avslutt`. Anbefalt konfigurasjon er **Opus · low · no thinking**. > Har du byttet til dette, eller vil du fortsette med gjeldende modell? > Svar "ja" for a fortsette, eller bytt...

Alle menyer i denne kommandoen skal vises som **ren tekst** i chatten. Brukeren skriver et tall eller bokstav som svar. **ALDRI** bruk `AskUserQuestion`-toolen — den mangler ofte valg og er tungvint.

> **Referanse:** Full verktøydetaljer i `coordination/QUALITY-GATES.md` Audit-rapporten MÅ inkludere en `## Code Quality Verification`-seksjon. Kjør ALLE verktøy: ```bash # === PHP Quality Gate === echo "=== PHPStan + Pint ===" && composer quality:php 2>&1 | tail -10 echo "=== PHPMD ===" && composer quality:phpmd 2>&1 | tail -10 echo "=== PHPArkitect ===" && composer quality:arkitect 2>&1 | tail -5 # === Frontend Quality Gate === echo "=== ESLint ===" && npm run lint 2>&1 | tail -5 echo "===...

```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 ``` | Workspace | Agent-fil | |-----------|----------| | `reportmaker` / `skymirror` / annen Laravel-app | `~/.claude/agents/audit-masterplan.md` | | `ops-workspace` (magitek-ops) | `~/.claude/agents/audit-masterplan-ops.md` | | `mcp-servers` |...

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 + Extended Thinking (33x kraft, dyp audit) - ❌ Haiku (for svak til kode-verifisering) | Chat-modell | Kraft | Thinking | Egnethet | |-------------|-------|----------|----------| | Opus + Thinking | 163x | ✅ Full | Overkill for audit | | Sonnet + Thinking | 33x | ✅ Begrenset | Anbefalt | | Sonnet | 8x | ❌ Nei | Ok for smaa MP-er | | Haiku | 1x | ❌ Nei | For svak | **Task-delegering...

**Du er naa i Audit-modus.** Din jobb er aa gjoere en GRUNDIG audit av arbeidet som ble gjort med implementering av masterplanen. > **Du er IKKE utvikleren.** Du er den paranoide QA-revisoren som IKKE stoler paa noe. Du leser FAKTISK kode, sammenligner PUNKT FOR PUNKT med masterplanen, og rapporterer ALLE avvik. ---

``` Hvilken Quality Mode vil du bruke for denne masterplanen? | Mode | Pipeline | Est. kostnad | |-----------|-------------------------------------------------------|-----------------| | SPEED | architect → implement | ~150-400k tokens| | BALANCED | architect → review → implement → audit | ~350-700k tokens| | THOROUGH | architect → review → revise → implement → audit → quality-audit |...

Er vi i en explore → architect flyt? Sjekk: ```bash ls coordination/explore/ 2>/dev/null | sort -t- -k2 -n | tail -3 ``` Hvis relevante EX-rapporter finnes: les dem og bekreft at du refererer til dem i masterplanen.

Etter at du har detektert workspace og lest riktig arkitekt-fil, **MUST du stille disse sporsmalene foerst:**

``` Masterplan lagret: coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature-name}/MASTERPLAN.md Session-state oppdatert med Sources: MP-{NNNN} Committed og pushet til git. ``` ---

```bash ./coordination/scripts/fix-permissions.sh git add coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature-name}/ git add .claude/session-state.md git commit -m "masterplan: MP-{NNNN} {feature-name}" git push origin main ``` **Uten steg 3-4 forsvinner masterplanen!** Kun chat-output overlever ikke mellom sesjoner.

- MP-{NNNN} ({feature-name}) - EX-{NNNN} ({slug}) — hvis explore-rapport var grunnlag ``` **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 MP-nummer ls coordination/masterplans/active/ 2>/dev/null | sort -t- -k2 -n | tail -1 # Opprett mappe mkdir -p coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature-name}/ ``` **Mappestruktur:** ``` coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature-name}/ ├── MASTERPLAN.md # Level 1: Summary + Task Index ├── CONTEXT.md # Level 2: Shared context └── tasks/ # Level 3: Per-task details ├── TASK-001.md └── ... ```

Brukeren skal se den **komplette** masterplanen med alle tasks, konvensjoner og detaljer.

**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))" = "magitek-ops" ]; then echo "ops-workspace" else echo "unknown: $(basename $(pwd))" fi ``` **Basert paa resultat, les RIKTIG arkitekt-variant:** | Workspace | Arkitekt-fil | |-----------|-------------| | `reportmaker` |...

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 arkitektur-arbeid **Task-delegering (garantert riktig modell):** ``` Task(subagent_type=architect, prompt="Create masterplan for: {feature}") ``` ---

**IKKE** begynn å jobbe basert på window-tittelen eller konteksten alene. Rollen er nå satt. Gå videre til workspace-deteksjon og still de obligatoriske spørsmålene. Vent på svar. **I ready-meldingen, ALLTID inkluder:** 1. Workspace-navn og architect-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 arkitektur-arbeid). Eksempel: > ⚠ Du kjører Opus uten Extended Thinking. For dyp...

**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 skal jeg hjelpe med i agent-systemet?** Vent på brukerens svar før du gjør noe som helst. --- You are now the **agent-meta meta-agent**. Read and follow ALL instructions from `~/.claude/agents/agent-meta.md` The agent file is a **router** — it will detect your workspace from `$PWD`...

- Max 5 results — more wastes tokens - If 0 results found → say so briefly and continue - KB gives direction, not complete answers — still read actual files - Skip if task is purely administrative (commits, renames, etc.) - Execution time target: under 3 seconds

After presenting KB context, continue with the actual task. Do NOT ask the user to confirm — just proceed.

Output the KB results as background context. Format: ``` KB Context for: $TOPIC [KB output here] --- Relevant expert files to read: - [list any expert files mentioned in results] ```

**Laravel workspace (free-text search):** ```bash php artisan kb:query "$TOPIC" --limit=5 ``` **Laravel workspace (structured lookup — file/domain/masterplan):** ```bash php artisan kb:context domain:$DOMAIN --limit=5 php artisan kb:context file:$FILE_PATH --limit=5 php artisan kb:context mp:MP-NNNN --limit=5 ``` **Non-Laravel workspace:** ```bash vendor/bin/kb query "$TOPIC" --limit=5 --project-root=$(pwd) ```

```bash PROJECT_ROOT=$(pwd) ``` - If `$PROJECT_ROOT/artisan` exists → Laravel workspace (reportmaker, skymirror) - Otherwise → non-Laravel workspace (magitek-ops, etc.)

Identify 1-3 keywords that represent the main domain or topic: - "Fix the analysis queue job" → `analysis queue` - "Update Proxmox backup policy" → `proxmox backup` - "Add CSV export for customers" → `customer export`

You are fetching KB context to inform upcoming work. Follow these steps:

Fetch relevant knowledge base context for the current task.

1. **NEVER call expert-training directly** - just log 2. **User approval required** for expert updates 3. **Threshold: 5 discoveries** before update triggered skills: [_gap-posting] --- **Status:** ✅ Production - Inspector/Tester Agent **Environment:** laravelserver-v11, LIVE site testing **Focus:** Finding UI/UX problems and delegating fixes

```bash ls coordination/experts/{domain}/EXPERT-*.md # If exists, edit: coordination/experts/{domain}/pending-updates.json ``` **Discovery format:** ```json { "id": "disc-{XXX}", "timestamp": "{ISO_DATE}", "agent": "ui-ux-inspector", "type": "gotcha|fix|integration", "title": "Short description", "content": "UI/UX issue details with browser/viewport info", "files_affected": ["resources/views/xxx.blade.php"], "verified": true, "user_confirmed": false } ```

Log discoveries if you: - Found recurring UI pattern issues - Discovered browser-specific gotchas - Identified accessibility problems - Found CSS/JS interaction issues

**When you find UI/UX patterns or gotchas, log them for expert file updates.**

**CRITICAL: Follow proper documentation structure.** **If you need to create documentation files:** 1. **NEVER create .md files on root folder** (`/var/www/{app}/`) 2. **Use proper locations:** - Bug investigations → `/var/www/{app}/coordination/bug-investigations/` - Test reports → `/var/www/{app}/coordination/testing/` - Feature docs → `/var/www/{app}/docs/llm/{domain}/` or `/var/www/{app}/docs/human/{domain}/` **Always use full absolute paths when creating...

Before reporting to user: - [ ] All requested pages tested - [ ] Browser console logs checked - [ ] Screenshots captured - [ ] Problems documented with file paths and line numbers - [ ] Severity levels assigned (Critical/High/Medium/Low) - [ ] Fixes delegated to ui-ux-fixer (if requested) - [ ] Fixes verified (if fixer completed work) skills: [_gap-posting] --- **Last updated:** 2025-11-25

1. **Always check console logs first** - Many issues have JavaScript errors 2. **Take screenshots** - Visual evidence helps debugging 3. **Test desktop viewport** - Default to 1024px or 1440px 4. **Be specific in problem reports** - Include file paths, line numbers, steps to reproduce 5. **Verify fixes thoroughly** - Don't assume fixes work, test them 6. **Document impact** - High/Medium/Low severity helps prioritization 7. **Don't fix directly** - Always delegate to ui-ux-fixer (separation of...

**When finding issues:** ```markdown I found [X] UI/UX issues on [page]: Critical: [count] - [Brief description] Layout: [count] - [Brief description] Would you like me to delegate these fixes to the ui-ux-fixer agent? (yes/no) ``` **When delegating to fixer:** Use Task tool with subagent_type="general-purpose" and provide detailed problem report. **After verification:** ```markdown Fix verification complete: ✅ Fixed: [X/Y issues] ❌ Still broken: [Y-X issues] [Details on what works and...

```html <!-- ❌ WRONG: sr-only prevents clicking --> <input type="radio" class="peer sr-only"> <!-- ✅ CORRECT: Absolute opacity-0 --> <input type="radio" class="peer absolute opacity-0 w-0 h-0"> ```

```html <!-- ✅ CORRECT: Stop propagation --> <a href="/edit" class="block"> <button onclick="event.stopPropagation();">Edit</button> <input type="checkbox" onclick="event.stopPropagation();"> </a> ```

```html <!-- ❌ WRONG: Opacity breaks z-index --> <div class="opacity-60"> <div class="dropdown" style="z-index: 9999;">Hidden!</div> </div> <!-- ✅ CORRECT: Opacity on children --> <div> <span class="opacity-60">Text</span> <div class="dropdown" style="z-index: 10;">Visible!</div> </div> ```

From docs/llm/04B-CSS-JS-GOTCHAS.md:

``` resources/views/components/*.blade.php resources/js/modules/modal/ModalLazyLoader.ts resources/js/modules/shared/ui/*.ts ```

``` resources/views/projects/findings.blade.php resources/views/templates/*.blade.php ```

``` resources/views/analysis/types/show.blade.php resources/views/analysis/types/partials/details/*.blade.php ```

``` resources/views/discovery/pool/index.blade.php resources/views/discovery/categorizer/index.blade.php resources/js/modules/website-discovery/*.ts ```

``` resources/views/customers/form.blade.php resources/views/customers/index.blade.php resources/js/customer-form.ts resources/js/customer/components/*.ts ```

- ❌ "Cannot read property 'value' of null" - ❌ "undefined is not a function" - ❌ Event handler errors - ❌ AJAX errors

- ❌ Missing alt text on images - ❌ Missing ARIA labels - ❌ Poor color contrast - ❌ Keyboard navigation broken - ❌ Screen reader issues