Kjell Tore Guttormsen 52f6e3bd71 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

2026-06-19 20:03:53 +02:00

4.7 KiB

Raw Permalink Blame History

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

Review (parallel/pipeline): hver ekspert-agent (Opus) leser sitt artefakt-sett → findings.
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.
Completeness-kritiker (1 agent): «hvilken linse/vinkel manglet panelet?» → eventuelt en ekstra runde.
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.

4.7 KiB Raw Permalink Blame History Unescape Escape