From 52f6e3bd714e15708a77a2d114d7cbed1ed4a75a Mon Sep 17 00:00:00 2001 From: Kjell Tore Guttormsen Date: Fri, 19 Jun 2026 20:03:53 +0200 Subject: [PATCH] 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) Claude-Session: https://claude.ai/code/session_016qgzo6rxthw7KuxHjn5vyE --- docs/expert-review/plan.md | 77 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/expert-review/plan.md diff --git a/docs/expert-review/plan.md b/docs/expert-review/plan.md new file mode 100644 index 0000000..031a220 --- /dev/null +++ b/docs/expert-review/plan.md @@ -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 (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: , + findings: [{ + area: , + severity: BLOCK | MAJOR | MINOR | NICE, + claim: , + evidence: , + recommendation: + }], + strengths: [] +} +``` + +## 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.