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:
parent
aaacb20a3f
commit
52f6e3bd71
1 changed files with 77 additions and 0 deletions
77
docs/expert-review/plan.md
Normal file
77
docs/expert-review/plan.md
Normal 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 (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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue