# Expert-Panel Review — Dynamic Workflow Spec

_Spec for et multi-agent ekspert-panel som vurderer hele LinkedIn Studio-pluginen og leverer en
prioritert roadmap. Kjøres **én gang etter at herdingen (S26) er ferdig**. Output fylles inn i
`docs/expert-review/roadmap.md`, som STATE.md peker til._

## Når
- **Forutsetning:** herding ferdig (S1–S26, alle 29 kommandoer gjennom kvalitetsgaten).
- **Trigger:** eksplisitt operatør-kommando (`Workflow`-verktøyet — ikke automatisk; kjøres aldri uten opt-in).
  Dette er en kostbar fan-out (panel × artefakt-sett). «Ingen skjulte kostnader» = stående ja, men kjøringen
  bekreftes likevel før start.
- **Scope:** vurderer pluginen **som produkt** — ikke en enkelt kommando. Komplementær til herdingen
  (herding = korrekthet/hygiene per kommando; ekspert-panel = strategisk produktverdi på tvers).

## Formål
Få en uavhengig, verdensklasse-vurdering av om pluginen faktisk gjør en bruker til en sterk personal-brand på
LinkedIn i 2026 — hva som er world-class, hva som mangler, hva som er feiljustert mot virkeligheten — og
destillere det til konkret, prioritert arbeid mot v1.0.0 og videre.

## Panelet (ekspert-arketyper, distinkte linser)
Arketyper, ikke navngitte virkelige personer (vi fabrikkerer ikke sitater i noens munn). Hver arketype er
destillert fra en reell skole/praksis for troverdighet, og bærer **én distinkt linse** så funnene ikke
overlapper.

| # | Arketype | Linse (hva den jakter på) | Destillert fra |
|---|----------|---------------------------|----------------|
| 1 | **Solopreneur-operatøren** | Offer↔content-fit, lead-gen-funnel, konsistens-systemer, ROI på tid | one-person-business-skolen |
| 2 | **Hook- & storytelling-håndverkeren** | Hooks, retorikk, narrativ spenning, scroll-stop, format-craft | viral short-form-skolen |
| 3 | **Personal-brand-strategen** | Posisjonering, differensiering, ICP-klarhet, authority-arkitektur | personal-branding-skolen |
| 4 | **Algoritme- & analytics-spesialisten** | Distribusjon, format-mix, timing, saves/dwell-realisme, datadrevet iterasjon | growth/analytics-skolen |
| 5 | **B2B thought-leadership / social-selling-lederen** | Pipeline, social selling, founder-led, employee advocacy | B2B-social-selling-skolen |
| 6 | **Autentisitets-/anti-AI-slop-kritikeren** | Generisk AI-stemme, «broetry»-tretthet, etterprøvbarhet, ekte stemme | de-AI / voice-skolen |

(Antall/arketyper kan justeres ved kjøring. Minst 5 distinkte linser anbefales.)

## Input pr. agent
Hver ekspert leser et **kuratert artefakt-sett** (ikke hele repoet — fokusert lesing):
- `CLAUDE.md` + `README` — kommando-/agent-inventar (29/19), arkitektur, gates.
- Et representativt utvalg command-filer for sin linse (f.eks. hook-håndverkeren leser `post`/`quick`/`carousel`;
  analytics-spesialisten leser `import`/`report`/`analyze`/`audit`/`ab-test`).
- Voice-systemet (`skills/.../SKILL.md`, voice-agentene, longform de-AI-gates).
- `references/algorithm-signals-reference.md` (SSOT) + relevante playbooks.
- `docs/hardening/log.md` (hva herdingen alt fant/fikset — unngå å re-rapportere løste ting).

## Per-ekspert output (schema)
Strukturert (StructuredOutput), aldri løs prosa:
```
{
  expert: <arketype>,
  findings: [{
    area: <kommando/agent/system>,
    severity: BLOCK | MAJOR | MINOR | NICE,
    claim: <hva som er svakt/manglende/world-class>,
    evidence: <fil:linje eller konkret observasjon>,
    recommendation: <konkret, etterprøvbart tiltak>
  }],
  strengths: [<hva som allerede er world-class — så roadmap ikke bare er kritikk>]
}
```

## Workflow-faser
1. **Review (parallel/pipeline):** hver ekspert-agent (Opus) leser sitt artefakt-sett → `findings`.
2. **Konsolidering (judge/synth):** dedupe på tvers av linser, severity-rank, tema-gruppér, kryss-referer mot
   `hardening/log.md` (drop alt allerede løst). Bevart: strengths-seksjon.
3. **Completeness-kritiker (1 agent):** «hvilken linse/vinkel manglet panelet?» → eventuelt en ekstra runde.
4. **Skriv** konsolidert, prioritert resultat → `docs/expert-review/roadmap.md`.

## Konsolidering → `roadmap.md` (format)
- **Executive summary** — panelets samlede dom (er dette world-class? hva holder det tilbake?).
- **Prioritert backlog** — tabell: tema · severity · funn · anbefaling · kilde-ekspert(er). Sortert BLOCK→NICE.
- **Strengths** — hva som allerede er sterkt (ikke rør).
- **Workstream-kobling** — hvert tiltak mappet til v1.0.0-veien (kommando-test · GUI · ny milestone).

## Drift
- **Opus på alt** (strategiske, human-facing funn). Schema-tvungne agenter for determinisme.
- Operatør-gatet output; ingen auto-merge til roadmap uten gjennomlesing.
- Kjøres når herdingen er ferdig — **ikke før**. STATE.md «Post-herding»-peker holder dette levende.
