docs(linkedin-studio): add post-herding expert-panel review workflow spec

Dynamic Workflow (6 expert archetypes, distinct lenses) that evaluates the whole
plugin after herding (S26) and consolidates findings into docs/expert-review/roadmap.md.
Operator-triggered, Opus, schema-forced. STATE.md points to it under the v1.0.0 path.
docs/-placed (not root ROADMAP.md) per the global no-local-mechanisms rule.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016qgzo6rxthw7KuxHjn5vyE
This commit is contained in:
Kjell Tore Guttormsen 2026-06-19 20:03:53 +02:00
commit 52f6e3bd71

View file

@ -0,0 +1,77 @@
# 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 (S1S26, 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.