```bash npm run build # Etter ALLE CSS/JS/TS/Tailwind-endringer ``` | 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 | | `app/**/*.php` (backend) | ❌ Nei | **Rekkefølge:** `npm run build` → `optimize:clear` → `queue:restart`

``` → 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-full: {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 Issue Detected Agent made expert-file, but placement is wrong: - Wrong location: coordination/experts/settings/ (created v2.0) - Correct location: coordination/experts/findings/manual-report-builder/ - Duplicates: Old version still in correct location Next: Have agent redo or manual cleanup? ``` skills: [_gap-posting] ---

❌ Gjør selv når agent gjorde dårlig jobb → Du gjentok feilen! ❌ Opprett symlinks selv → Du kjenner ikke reglene ❌ Slett expert-filer selv → Kan være i bruk ✅ Verifiser med sjekklisten ✅ Hvis FEIL: Rapporter til bruker med spesifikk issue ✅ La bruker bestemme om remediation

**1. ✅ PLACEMENT** → Expert i `coordination/experts/{category}/{domain}/` (IKKE `settings/`, `plans/`, root) **2. ✅ SYMLINK** → `file CURRENT.md` må si "symbolic link" **3. ✅ DUPLICATES** → `find coordination/experts -name "*title*" -type f` → max 1 fil **4. ✅ VERSION** → Nyeste versjon pekt av CURRENT.md symlink **5. ✅ ARCHIVE** → Gamle versjoner i `_archive/` (IKKE i root)

**KRITISK:** Når agent spawner og oppdaterer expert-filer - verifiser plassering FØR du gjør arbeidet selv!

**Kontekst-lasting koster tokens. Les RIKTIG rekkefølge:** ``` 1. Handoff-fil FØRST (~1k tokens) → Sjekk "Status:" feltet 2. Expert-fil KUN hvis nødvendig (~5k tokens) 3. ALDRI les plan-filer automatisk! (~25k+ tokens waste) ``` **Decision Tree:** ``` Handoff Status = "Complete"? ├─ YES + uklar instruksjon → SPØR BRUKER ├─ YES + klar instruksjon → UTFØR └─ NO (In Progress) → Les expert, evt. plan ``` **IGNORER "Plan Reference:" i expert-filer** - plan = historisk, ikke nødvendig for løpende...

``` ⚠️ 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 - Orchestrator kan ha aktive worktrees - KOORDINER! ❌ 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] ---

**📢 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. **CRITICAL:** Before spawning agents, analyze complexity → select optimal agent. | Type | Agent | Cost | Criteria | |------|-------|------|----------| | Simple | generic-light | 1x | <50 LOC, 1-2 files, add/fix | | Moderate | generic-fast-thinking | 4x | 50-200 LOC, 2-5 files, needs analysis | | Complex |...

- 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] ---

``` 🐛 Dette høres ut som debugging/feilsøking. Dev-agenter er optimalisert for å BYGGE, ikke DIAGNOSTISERE. Bug-crusher (Opus+Extended Thinking) er designet for: → Root cause analysis (5x "Hvorfor?") → Data flow tracing gjennom hele stacken → Systematisk hypotese-eliminering Alternativer: 1. /bug-crusher → Dyp debugging med extended thinking (anbefalt for ukjent årsak) 2. /solo-bug-light → Troubleshooter mode med smart agent selection (lettere) 3. Fortsett her → Hvis det er en...

| Kategori | Nøkkelord | |----------|-----------| | **Direkte** | bug, feil, error, exception, crash, broken, ødelagt, virker ikke, fungerer ikke, feiler | | **Symptomer** | blank side, 500, 404, null, undefined, timeout, spinner, feil data, viser feil, tom, mangler | | **Debugging** | hvorfor, undersøk, finn ut, debug, trace, reproduser, merkelig, rart, uventet |

**Når bruker-prompt inneholder bug/feil-signaler, STOPP og foreslå delegering FØR du starter!**

**Kode på main med orchestrator-koordinering.**

- Rediger `~/.claude/hooks/` eller `~/.claude/lib/` direkte - Commit uten syntaks-sjekk - Push uten kvalitetstest - Fiks symptomer uten å finne root cause

**ALLTID kjør FØR og ETTER fix:** ```bash bash -n engine/hooks/*.sh engine/lib/*.sh # Syntaks ./engine/test/quality-test.sh # Kvalitet ./engine/test/quality-test.sh --regression # Regresjon (hvis baseline finnes) ``` skills: [_gap-posting] ---

- **SYN-08:** DB = `coordination/knowledge.db` (IKKE `knowledge_base.sqlite`) - **SYN-09:** `kb_query_rich()` returnerer JSON — markdown-format gir tomme headers - **SYN-10:** L3 = ~6s (Gemini timeout), kun første prompt per sesjon - **SYN-11:** Title-based dedup kan slå sammen distinkte entries - **artisan JSON footer:** `kb:query --format=json` legger til "Found N results" etter JSON array — parser bruker `rfind(']')` fallback - **L3 providers:** Kun Gemini CLI funker i hook-kontekst...

```bash systemctl status syncrovanis-dashboard journalctl -u syncrovanis-dashboard --since "1 hour ago" --no-pager python3 -c "import py_compile; py_compile.compile('dashboard/app.py')" cd /var/www/syncrovanis/dashboard && python3 -c "from data.log_reader import read_log; print(len(list(read_log())))" ``` skills: [_gap-posting] ---

```bash # Syntaks-sjekk bash -n engine/hooks/*.sh engine/lib/*.sh # Test enkelt prompt echo '{"prompt":"test","cwd":"/var/www/reportmaker","session_id":"debug-001"}' | \ bash engine/hooks/user-prompt-context-engine.sh # Sjekk JSONL logg tail -20 ~/.claude/logs/syncrovanis.jsonl | python3 -m json.tool # Kvalitetstest (identifiserer failing prompts) ./engine/test/quality-test.sh --workspace reportmaker # Test klassifisering isolert source engine/lib/classify.sh...

**Engine (Bash):** Hook pipeline that runs on EVERY prompt. ``` engine/hooks/user-prompt-context-engine.sh — Main pipeline engine/lib/classify.sh — Classification (L1/L2) engine/lib/kb-query.sh — KB query engine/lib/llm-classify.sh — L3 LLM engine/lib/state.sh — Session state engine/lib/workspace-detect.sh — Workspace detection ``` **Dashboard (Python/Flask):** Read-only monitoring on port...

Analyser kompleksitet FØR du spawner agent: | Bug Type | Agent | Cost | Criteria | |----------|-------|------|----------| | Simple | generic-light | 1x | Typo, syntax, missing quote | | Moderate | generic-fast-thinking | 4x | Logic error, needs investigation | | Complex | generic-balanced-thinking | 33x | Cross-component, race condition | | Cryptic | bug-crusher-syncrovanis | 163x | Root cause unknown | skills: [_gap-posting] ---

**Finn og fiks feil — diagnostikk først.** skills: [_gap-posting] ---

``` ✅ Rotårsak identifisert og fikset ✅ php -l (syntax OK) ✅ npm run build (hvis CSS/JS/Tailwind endret) ✅ php artisan optimize:clear ✅ php artisan queue:restart (hvis Jobs/Services/Config) ✅ Discovery logget til relevant domain ✅ HANDOFF skrevet (coordination/handoffs/HANDOFF-{NNN}-{YYMMDD}-{desc}.md) ⚠️ FRONTEND: Bruker MÅ teste [URLer] - verifiser fix ```

> **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...

**KRITISK: Sjekk relevant expert-fil FØRST - sparer 80% tid!** ```bash ls coordination/experts/*/EXPERT-*.md ``` Vanlige domener for bugs: - `analysis-details-system` - Analysis rendering, 298 rules - `ui-ux-system` - Frontend, design tokens - `enrichment-system` - Discovery, verification - `seo-analysis` - SEO rules, thresholds skills: [_gap-posting] ---

``` app/Http/Controllers/ # Route handlers app/Models/ # Eloquent models app/Services/ # Business logic (queue restart!) app/Services/Analysis/ # Analysis logic (queue restart!) app/Jobs/ # Queue jobs (queue restart!) resources/views/ # Blade templates storage/logs/ # Laravel logs 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] ---

**KRITISK: Logg ALLE bug fixes for system-læring!** Når du fikser en bug: 1. Bestem domene: `analysis-details-system`, `ui-ux-system`, etc. 2. Logg til: `coordination/experts/{domain}/pending-updates.json` **Format:** ```json { "id": "disc-{NNN}-{slug}", "timestamp": "ISO-8601", "agent": "solo-bug-light", "type": "fix", "severity": "low|medium|high|critical", "title": "Kort tittel", "content": "Beskrivelse med fil:linje referanser", "files_affected": ["path/to/file.php:123"], ...

**ALDRI si "bug fikset" uten bruker-validering!** ``` DU kan verifisere: ✅ Backend-kode, database, syntax, tester, logs DU kan IKKE verifisere: ❌ Frontend-visning, JavaScript-feil, UX-problemer ``` **ALLTID si:** ``` ✅ Bug-fix implementert ⚠️ FRONTEND VALIDERING PÅKREVD Test denne siden for å bekrefte fix: - [URL til påvirket side] Status: Venter på din validering ``` skills: [_gap-posting] ---

```bash # Backend logs tail -50 storage/logs/laravel.log # Frontend logs (uten DevTools!) php artisan logs:browser --errors-only # Database php artisan tinker --execute="Model::find(X)" # Finn controller grep -r "routeName" routes/web.php # Finn Service grep -r "ClassName" app/Services/ ``` skills: [_gap-posting] ---

``` 1. REPRODUSER → Forstå eksakt hva som feiler 2. ISOLER → Frontend eller backend? 3. DIAGNOSTISER → Rotårsak, ikke symptom 4. FIX → Minimal endring 5. VERIFISER → Cache + Queue + Test ``` **KRITISK steg 5:** Etter fix, ALLTID kjør: ```bash php artisan optimize:clear php artisan queue:restart # Hvis Jobs/Services/Config! ``` 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] ---

[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 ├──...