> **Referanse:** `coordination/QUALITY-GATES.md` ```bash # Kjør kvalitetssjekk på endrede filer: composer lint 2>&1 | tail -20 # PHPStan + Pint + PHPMD + PHPArkitect npm run lint 2>&1 | tail -10 # ESLint ``` **Hard stops (MÅ fikses):** PHPStan-feil, PHPArkitect-brudd, ESLint-feil **Auto-fix:** `composer pint-fix` (PHP style) **Advarsler:** PHPMD complexity, Knip dead code → fiks hvis enkelt skills: [_gap-posting] ---

**Når bruker refererer til en URL, knapp, modal, eller seksjon:** ```bash # STEG 1: Alltid kjør ui:lookup FØRST php artisan ui:lookup "customers/{customer}/edit" --json # → controller, metode, area php artisan ui:lookup "knapp-tekst" --fuzzy --json # → fuzzy søk # STEG 2: Bruk Serena for å navigere til koden mcp__serena__find_symbol → forstå controller/service mcp__serena__find_referencing_symbols → spor kall-kjeder ``` **Fallback (kun hvis ui:lookup ikke finner noe):** - **Route...

```bash ls coordination/experts/*/EXPERT-*.md ``` skills: [_gap-posting] ---

``` app/Http/Controllers/ # Route handlers app/Models/ # Eloquent models app/Services/ # Business logic resources/views/ # Blade templates database/migrations/ # Schema (SPØR FØRST!) coordination/experts/ # Expert knowledge files ``` skills: [_gap-posting] ---

- **Backend:** Laravel 12, PHP 8.3, MariaDB - **Frontend:** Blade, Vanilla JS, Tailwind CSS - **Services:** Puppeteer (Node.js :3001), Wappalyzer (Python) skills: [_gap-posting] ---

**Når du fikser en bug eller oppdager noe viktig:** 1. Bestem domene: `analysis-details-system`, `ui-ux-system`, etc. 2. Logg til: `coordination/experts/{domain}/pending-updates.json` **I din sluttrapport, ALLTID inkluder:** ``` **Discoveries logged:** X item(s) til {domain} - [type] Tittel (severity) ``` skills: [_gap-posting] ---

**ALDRI si "ferdig" uten bruker-validering!** ``` DU kan verifisere: ✅ Backend-kode, database, syntax, tester DU kan IKKE verifisere: ❌ Frontend-visning, JavaScript-feil, UX-problemer ``` **ALLTID si:** ``` ✅ Backend-endringer fullført ⚠️ FRONTEND VALIDERING PÅKREVD Test disse sidene: - [liste med URLer] Status: Venter på din validering ``` skills: [_gap-posting] ---

```bash tail -50 storage/logs/laravel.log php artisan logs:browser --errors-only php artisan tinker ``` skills: [_gap-posting] ---

```bash # 1. Pull git pull origin main # 2. Sjekk for andres arbeid git status # Er alt dette MITT? # 3. Kode + test php -l fil.php # Syntax php artisan test # Tests # 4. Cache php artisan optimize:clear # 5. Commit (selektiv!) git add fil1 fil2 # Kun DINE filer git commit -m "feat: beskrivelse" git push origin main ``` skills: [_gap-posting] ---

**Multiple LLM-instanser jobber samtidig!** ```bash # FØR du pusher til main - sjekk for aktive worktrees: git worktree list | grep -v "\[main\]" # Hvis worktrees eksisterer: # → Dine commits til main kan forårsake merge-konflikter for orchestrator # → Orchestrator har konflikt-deteksjon, men koordinering er bedre ``` skills: [_gap-posting] ---

**Når du spawner agenter med Task tool:** **📢 ALLTID VERBOSE (BLOCKING) OUTPUT!** Agenter skal ALDRI kjøres med `run_in_background: true`. Kjør agenter synkront (blocking) slik at full verbose output vises i sanntid. Brukeren vil alltid se hva agentene gjør - aldri bare en "venter..."-melding. **⚠️ AGENTER KAN OVERSKRIVE DINE ENDRINGER!** Agenter får IKKE automatisk kontekst om dine uncommitted changes. Du MÅ inkludere denne informasjonen i promptet. **ALLTID inkluder i...

[Hva neste sesjon bør gjøre] ``` **Commit handoff:** ```bash git add coordination/handoffs/HANDOFF-{NNN}-*.md git commit -m "handoff: {kort beskrivelse}" git push origin main ``` skills: [_gap-posting] ---

| File | Change | |------|--------| | path/to/file.php | Beskrivelse |

- [Bugs, mangler, TODO]

- [Konkrete endringer med fil:linje-referanser]

**SKRIV ALLTID handoff ved sesjonsavslutning:** ```bash # Finn neste nummer: ls coordination/handoffs/HANDOFF-*.md 2>/dev/null | sort -t- -k2 -n | tail -1 ``` **Handoff-format:** ```markdown # HANDOFF-{NNN}: {Kort tittel} **Status:** In Progress / Complete / Blocked **Date:** YYYY-MM-DD **Session:** {solo-mode} on {branch}

**CRITICAL: coordination/ root must stay clean!** ``` ✅ ALWAYS use correct subdirectory: coordination/ ├── handoffs/ ← HANDOFF-{NNN}-{YYMMDD}-{desc}.md ├── masterplans/ ← active/MP-*/ + completed/YYYY/MM-mnd-ukeNN/MP-*/ ├── experts/ │ └── handoffs/ ← Knowledge handoffs (bug-crusher etc.) ├── tasks/ ← TASK-*.md ├── audits/ ← AUDIT-*, ANALYSE-*, GAP-ANALYSIS-*.md ├── task-completion/ ← COMPLETION-*.md ├──...

```bash ❌ FORBUDT (BLOKKERT - ødelegger produksjon): - migrate:fresh - migrate:reset - db:wipe - migrate:refresh ✅ TILLATT (kun etter bruker-godkjenning): php artisan migrate # Forward-only php artisan migrate:rollback --step=1 # Kun siste ```

```bash php artisan optimize:clear ```

```bash npm run build # Etter ALLE CSS/JS/TS/Tailwind-endringer ``` **Når trengs build?** | Endret fil | Build? | |------------|--------| | `resources/css/*.css` | ✅ JA | | `resources/js/**/*.{js,ts}` | ✅ JA | | `*.blade.php` med NYE Tailwind-klasser | ✅ JA | | `tailwind.config.js`, `vite.config.js` | ✅ JA | | `*.blade.php` (kun PHP/HTML) | ❌ Nei | | `app/**/*.php` (backend) | ❌ Nei | **Riktig rekkefølge etter mixed changes:** ```bash npm run build # 1. Frontend...

``` → Navbar [Q ↻] RØD = trenger restart → klikk → Eller: php artisan queue:restart && php artisan optimize:clear ``` **Når trengs restart?** | Endret fil | Restart? | |------------|----------| | `app/Jobs/*.php` | ✅ JA | | `app/Services/*.php` | ✅ JA | | `config/*.php` | ✅ JA | | `resources/views/*.blade.php` | ❌ Nei | | `resources/js/*.js` | ❌ Nei (men trenger npm build!) |

```bash # FØR du stasher - SJEKK FØRST: git status --porcelain # Spør deg selv: "Er ALLE disse endringene MINE?" # - Filer jeg opprettet/endret: ✅ Mine # - Filer jeg ikke kjenner igjen: ❌ Andres arbeid! # Hvis >3 stashes eksisterer, STOPP! git stash list # ❌ ALDRI stash uten å sjekke først # ❌ ALDRI stash andres arbeid # ✅ Hvis må stashe: git stash push -m "solo-dev: {grunn} - {dato}" # ✅ Drop din stash når ferdig ``` **Hvis du finner ANDRES uncommitted endringer:** ``` ⚠️ STOPP! Fant...

```bash git add fil1 fil2 # ✅ Kun DINE filer git add . # ❌ ALDRI! Stager andres arbeid! ```

``` Hvis du ser feil med: - /home/heine/.claude/projects/-tmp/ - /home/heine/.claude/todos/ - /home/heine/.claude/projects/ → www-data mangler skrivetilgang til Claude CLI-mapper! Be brukeren kjøre: setfacl -R -m u:www-data:rwx /home/heine/.claude/projects/-tmp/ setfacl -d -m u:www-data:rwx /home/heine/.claude/projects/-tmp/ setfacl -R -m u:www-data:rwx /home/heine/.claude/todos/ setfacl -d -m u:www-data:rwx /home/heine/.claude/todos/ setfacl -m u:www-data:rwx...

``` ❌ sudo/chown/chmod/apt = FUNGERER IKKE ✅ Be brukeren kjøre privilegerte kommandoer SPESIALTILFELLE - Puppeteer restart: ✅ sudo systemctl restart puppeteer-server (fungerer med sudo!) ✅ POST /operations/puppeteer/restart (via REST API, no sudo) ```

``` DENNE SERVEREN (172.20.0.94): ├─ Apache 2.4 + PHP-FPM 8.3 (IKKE nginx!) ├─ :80 → Apache HTTP ├─ :8081 → Laravel Reverb (WebSocket) ├─ :3001 → Puppeteer (Node.js) └─ Vhost: /etc/apache2/sites-enabled/reportmaker.magitek.no.conf EKSTERN REVERSE PROXY (172.20.0.42) - Nginx Proxy Manager: ├─ SSL-terminering (Let's Encrypt, Force SSL + HTTP/2) ├─ https://reportmaker.magitek.no → http://172.20.0.94:80 └─ /app (WebSocket) → http://172.20.0.94:8081 ❌ ALDRI: nginx-kommandoer (finnes ikke...

``` ✅ FAKTA: ❌ IKKE SJEKK FOR: - Ingen auth/login - Auth middleware - Ingen middleware-beskyttelse - Login-redirects - Ingen bruker-sesjoner - Session-problemer - Ruter er direkte tilgjengelige - Permission-feil ``` skills: [_gap-posting] ---

``` ⚠️ Expert File Placement Issue Detected Agent lagde expert-fil, men der er problemer: 1. **Wrong Placement:** Created: coordination/experts/settings/EXPERT-manual-report-settings-*.md Should be: coordination/experts/findings/manual-report-builder/EXPERT-manual-report-settings-*.md 2. **Duplicates Found:** - coordination/experts/settings/EXPERT-* (NEW - wrong place) - coordination/experts/findings/manual-report-builder/EXPERT-* (OLD - correct place) 3. **Next Steps:** ...

``` ❌ ALDRI gjør selv når agent har gjort dårlig jobb → Du gjentok feilen (gjorde det selv istedenfor) → Nå var det duplikater + feil plassering ❌ ALDRI opprett symlinks selv → Expert system har regler du kjenner ikke ❌ ALDRI slett expert-filer selv → Kan være i bruk av andre agents ISTEDEN: ✅ Verifiser med sjekklisten ✅ Hvis FEIL: Rapporter TIL BRUKER med spesifikke problemer ✅ La bruker bestemme remediation ```

| Problem | Symptom | Løsning | |---------|---------|---------| | **Wrong placement** | Expert i `settings/` i stedet for `findings/` | Don't fix yourself - report to agent | | **Missing symlink** | CURRENT.md mangler | Don't create symlink yourself - report | | **Broken symlink** | CURRENT.md peker på manglende fil | Agent must recreate | | **Duplicates** | Samme fil på 2 steder | Agent must consolidate | | **Not archived** | Gamle versjoner i root | Agent must move to _archive/ |

``` 1. ✅ PLACEMENT CHECK Finnes expert-fil på RIKTIG plass? Pattern: coordination/experts/{category}/{domain}/EXPERT-*.md FEIL STEDER (= Agent-feil): ❌ coordination/experts/settings/EXPERT-*.md ❌ coordination/experts/plans/EXPERT-*.md ❌ Root coordination/ (direkte) → Hvis FEIL plass: STOPP! Ikke gjør selv. → Rapporter til agent med riktig path. 2. ✅ SYMLINK CHECK Finnes korrekt CURRENT.md symlink? Verifiser: $ file coordination/experts/{domain}/CURRENT.md ...

**KRITISK:** Når agent spawner (Task tool) og oppdaterer/opprettet expert-filer:

- Du skal endre/utvide arkitekturen - Du trenger å forstå design-beslutninger - Bruker spør eksplisitt om plan-kontekst skills: [_gap-posting] ---

- Handoff sier "✅ Complete" - Handoff sier "Ready for Testing" - Expert-fil har nyere dato enn plan - Oppgaven er å "fortsette" uten spesifikk feature

``` Handoff Status = "Complete"? ├─ YES + uklar instruksjon → SPØR BRUKER │ "Handoff sier Complete. Hva er neste oppgave?" ├─ YES + klar instruksjon → UTFØR (kun expert hvis trengs) └─ NO (In Progress) → Les expert, evt. plan for kontekst ```

| Anti-Pattern | Token Cost | Riktig Tilnærming | |--------------|------------|-------------------| | Lese plan-fil når handoff = "Complete" | ~25k waste | Spør bruker om oppgave | | Lese expert-fil + plan-fil + kildekode | ~50k+ | Les kun det nødvendige | | "Plan Reference:" i expert → les alt | ~25k waste | IGNORER plan-referanser |

``` 1. Handoff-fil FØRST (~1k tokens) → Sjekk "Status:" feltet → Les "Next LLM Instruction" 2. Expert-fil KUN hvis nødvendig (~5k tokens) → Dokumenterer CURRENT state → Gotchas og patterns 3. ALDRI les plan-filer automatisk! (~25k+ tokens) → Plan = historisk "hvordan vi bygde dette" → Kun relevant hvis du skal ENDRE arkitekturen ```

**Kontekst-lasting koster tokens. Les RIKTIG rekkefølge:**

``` ⚠️ FAKTA: - Dette ER produksjonsserveren (ingen staging/dev) - Alle endringer påvirker LIVE data umiddelbart - Ingen test-database - migrasjoner påvirker ekte data - Multiple LLM-sesjoner jobber SAMTIDIG ❌ ALDRI anta at dette er test/dev-miljø! ``` skills: [_gap-posting] ---

- **Context7** — Oppdatert dokumentasjon for Laravel, PHP, JS-biblioteker - **Playwright** — Nettleserautomatisering, skjermbilder, UI-testing - **MySQL** — Direkte DB-spørringer (3-lags sikkerhet, safety hooks aktive) - **Lighthouse** — Ytelse/SEO/tilgjengelighetsrevisjoner - **Accessibility** — WCAG-testing (axe-core) - **CSS** — Stilark-analyse, MDN-dokumentasjon skills: [_gap-posting] ---

**Når bruker refererer til en URL, knapp, modal, eller seksjon — kjør dette FØRST:** ```bash php artisan ui:lookup "customers/{customer}/edit" --json # Eksakt rute php artisan ui:lookup "aksjonær" --fuzzy --json # Fuzzy søk php artisan ui:lookup "modalId" --type=modal --json # Modal-oppslag ``` Dette gir deg controller, metode, og area umiddelbart — deretter bruk Serena for å navigere koden.

**Når du utforsker kode, BRUK SERENA FØR Grep/Read:** ``` 1. mcp__serena__find_symbol (name_path="ClassName", include_body=false) → Finn klasse/metode uten å lese hele filen 2. mcp__serena__get_symbols_overview (relative_path="app/Services/Foo.php") → Se alle metoder/properties i en fil uten å lese den 3. mcp__serena__find_symbol (name_path="ClassName/methodName", include_body=true) → Les KUN metoden du trenger 4. mcp__serena__find_referencing_symbols (symbol_name="methodName") →...

Alle MCP-servere er aktive med deferred loading (0 kontekstkostnad til bruk).

| Bruker Sier | Riktig Agent | Kostnad | Modus | |-------------|-------------|---------|-------| | "Oppdater/lag expert-fil" | `expert-training` | Opus 38x | WRITE | | "Valider/sjekk expert-fil" | `expert-validator` | Haiku 1x | READ-ONLY | - `expert-validator` endrer ALDRI filer - kun validering og drift-rapport. - `expert-training` er for CREATE/UPDATE av expert-filer (Opus, dyrt men nødvendig). skills: [_gap-posting] ---

```xml <invoke name="Task"> <subagent_type>generic-fast-thinking</subagent_type> <!-- ← Smart selection --> <model>haiku</model> <!-- ← Matches agent --> <prompt> Fix validation bug in CustomerController with root cause analysis. Complexity: moderate (needs investigation + 3 file changes) Selected agent: generic-fast-thinking (4x) instead of generic-development (8x) = 50% cheaper ✅ </prompt> </invoke> ``` **Red Flags:** - ❌ Always using generic-development → Not optimizing - ❌ Using...

| Scenario | Unoptimized | Optimized | Savings | |----------|-------------|-----------|---------| | 10 simple tasks | 10x generic-development (80x) | 10x generic-light (10x) | **87%** | | 5 moderate bugs | 5x generic-development (40x) | 5x generic-fast-thinking (20x) | **50%** |

**SIMPLE (→ generic-light, Haiku 1x):** - Files: 1-2 - LOC: < 50 lines - Keywords: add, fix (typo/syntax), create (simple) - Examples: Add button, add field to form, fix typo, add translation key, simple migration **MODERATE (→ generic-fast-thinking, Haiku+Thinking 4x):** - Files: 2-5 - LOC: 50-200 lines - Keywords: fix (with investigation), refactor (local), analyze, validate - Examples: Bug fix with root cause analysis, multi-step migration, validation logic across controllers **COMPLEX (→...

| Task Type | Agent | Cost | When to Use | |-----------|-------|------|-------------| | **Simple** | generic-light | 1x | <50 lines, clear pattern, add/fix simple | | **Moderate** | generic-fast-thinking | 4x | Bug with root cause, refactor local, 2-5 files | | **Complex** | generic-balanced-thinking | 33x | Cross-domain, architectural, 5-10 files | | **Synthesis** | generic-quality | 38x | Expert files, UI scoring, docs |

**CRITICAL:** Before spawning agents with Task tool, analyze task complexity to select optimal agent.

- Bruker sier "bare fiks", "enkel fix", "quick fix" → Åpenbart triviell - Fixen er synlig (typo, manglende import, syntaksfeil, manglende komma) - Bruker eksplisitt ber om å fortsette i dev-mode - Bruker allerede har identifisert årsak og løsning skills: [_gap-posting] ---