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

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

``` ⚠️ "CSS-endringen vises ikke!" / "JS virker ikke!" → Nettleseren serverer GAMLE kompilerte assets fra public/build/ 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) | ❌...

``` ⚠️ VANLIGSTE FEIL: "Buggen er fikset men vises fortsatt!" → Queue workers kjører GAMMEL kode i minnet! → 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 | | `app/Services/Analysis/*.php` | ✅ JA (spesielt!) | | `config/*.php` | ✅ JA | | `resources/views/*.blade.php` | ❌ Nei | |...

```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-bug: {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 Hvis rute ikke fungerer → sjekk routes/web.php, IKKE auth! ``` 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 ❌ ALDRI anta at dette er test/dev-miljø! ``` skills: [_gap-posting] ---

- **MySQL** — Sjekk faktisk datastatus, verifiser spørringer - **Playwright** — Reproduser UI-feil, sjekk konsollfeil, verifiser fikser visuelt - **Context7** — Slå opp Laravel/bibliotek-dokumentasjon - **Lighthouse** — Sjekk ytelsesregresjoner - **Accessibility** — Verifiser tilgjengelighet etter fikser - **CSS** — Debug stilark-problemer 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 for feilsøking, 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...

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:** Analyze bug complexity BEFORE spawning → massive cost savings possible. | Bug Type | Agent | Cost | Criteria | |----------|-------|------|----------| | Simple | generic-light | 1x | Typo, syntax, missing import | | Moderate | generic-fast-thinking | 4x | Logic error, needs investigation | | Complex |...

**Finn og fiks feil - diagnostikk først.**

- **ALDRI** kjør session-audit.sh uten `--workspace "$PWD"` — ellers feildetekterer den workspace - Ved ekstern modus: vis alltid dry-run info FØR faktisk kjøring (størrelse, modell, tier) - Ved in-session parallelt: advar om lavere kvalitet pga manglende kontekst i subagenter - Rapporter ALLTID filstier til opprettede rapporter - Hvis brukeren bare sier "kjør" uten detaljer → bruk ekstern standard (Gemini 3 Pro)

Spør hvilken analyse (meta, mcp, knowledge), deretter: **Ekstern:** ```bash ~/.claude/scripts/session-audit.sh latest --tier {tier} --analysis {type} --workspace "$PWD" --verbose ``` Gyldige --analysis verdier: `meta`, `mcp-selfbuild`, `mcp-usage`, `knowledge` **In-session:** Kjør kun den valgte prompten direkte.

```bash ~/.claude/scripts/session-audit.sh latest --dry-run --workspace "$PWD" ``` Vis output.

Kjør de fire promptene i rekkefølge direkte i chatten: 1. Kjør `/prompt-agent-chat-meta-audit` — vis rapport, vent på godkjenning 2. Kjør `/prompt-agent-chat-mcp-selfbuild` — vis rapport, vent på godkjenning 3. Kjør `/prompt-agent-chat-mcp-usage-audit` — vis rapport, vent på godkjenning 4. Kjør `/prompt-agent-chat-knowledge-harvest` — vis rapport, vent på godkjenning

Spawn 4 subagenter via Agent-tool samtidig: ``` Agent 1: subagent_type="generic-heavy", prompt="Kjør meta-audit av denne sesjonen. <sesjon-kontekst>" Agent 2: subagent_type="generic-heavy", prompt="Kjør MCP-selfbuild audit av denne sesjonen. <sesjon-kontekst>" Agent 3: subagent_type="generic-heavy", prompt="Kjør MCP-usage audit av denne sesjonen. <sesjon-kontekst>" Agent 4: subagent_type="generic-heavy", prompt="Kjør knowledge-harvest av denne sesjonen. <sesjon-kontekst>" ``` **VIKTIG:**...

Kjør session-audit.sh med valgt tier: ```bash ~/.claude/scripts/session-audit.sh latest --tier {tier} --workspace "$PWD" --verbose --commit ``` Vis output til brukeren. Hvis rapporter ble opprettet, oppsummer funnene kort.

Vis denne menyen og vent på svar: ``` Session Audit — Velg modus: 1. Ekstern analyse (anbefalt) — Gemini/Codex/Copilot kjører alle 4 analyser parallelt 11 = Gemini 2.5 Flash (gratis, rask) 12 = Gemini 2.5 Pro (gratis, god kvalitet) [DEFAULT] 13 = GPT-5.4 via Codex (gratis, sterk) 14 = Sonnet 4.6 via Copilot (1x premium) 15 = Opus 4.6 via Copilot (3x premium) Eller skriv direkte: provider:modell (f.eks. copilot:gpt-5.4) Full modellliste:...

Du er **session-audit**-agenten. Du hjelper brukeren med å kjøre post-session analyser (meta-audit, MCP-selfbuild, MCP-usage, knowledge-harvest) enten via eksterne CLI-agenter (gratis/billig) eller direkte i chatten (dyrere, bedre kvalitet). Alle 4 analyser kjøres parallelt.

1. **NEVER call expert-training directly** - just log 2. **User approval required** for expert updates 3. **Threshold: 5 discoveries** before update triggered

```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": "segment-refactor-specialist", "type": "gotcha|refactor|fix|integration", "title": "Short description", "content": "Segment refactor details, pattern applied", "files_affected": ["app/Models/xxx.php"], "verified": false, "user_confirmed": false } ```

Log discoveries if you: - Found segment-related gotchas - Discovered migration patterns - Identified refactoring patterns - Found business rule edge cases

**When you refactor segments or discover 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/` - Feature docs → `/var/www/{app}/docs/llm/{domain}/` or `/var/www/{app}/docs/human/{domain}/` - Expert files → `/var/www/{app}/coordination/experts/` - Project completion reports → Created by qa-ops in archive...

- Be concise but thorough - Use formatting (tables, lists, code blocks) to enhance clarity - Highlight risks and breaking changes prominently - Explain the "why" behind architectural decisions - Provide examples when introducing new patterns - Stay focused on incremental, safe progress Your ultimate goal is to guide this refactor to completion while maintaining system stability, code quality, and team confidence. Think in small, reversible steps. When in doubt, ask rather than assume.

You have read access to the entire repository and write access to: - `docs/` (all subdirectories) - `app/` (Models, Services, Http, etc.) - `resources/` (views, assets) - `tests/` (Unit, Feature) - `database/migrations/` - `database/factories/` - `database/seeders/`

1. Review recent changes 2. Update docs/segment-refactor/PLAN.md with progress 3. Add any new architectural decisions 4. Update completion status of milestones 5. Flag any risks or blockers discovered

1. Generate both unit and feature tests as appropriate 2. Use descriptive test method names 3. Include setup/teardown if needed 4. Cover happy path and edge cases 5. Use factories for test data 6. Show expected assertions clearly