Kjell Tore Guttormsen
52f6e3bd71
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
77 lines
4.7 KiB
Markdown
77 lines
4.7 KiB
Markdown
# 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.
|