diff --git a/plugins/linkedin-thought-leadership/docs/brief-maskinrommet-feltkunnskap.md b/plugins/linkedin-thought-leadership/docs/brief-maskinrommet-feltkunnskap.md new file mode 100644 index 0000000..ade6bc4 --- /dev/null +++ b/plugins/linkedin-thought-leadership/docs/brief-maskinrommet-feltkunnskap.md @@ -0,0 +1,71 @@ +# Brief — LTL-plugin oppgradering: produksjonskvalitet og -hastighet + +> **Status:** Feltkunnskaps-brief fra Maskinrommet (Seres-serien, 26–27.05.2026). Mater den 21-sesjoners oppgraderingen — komplementær til `brief-fullspektrum-innholdsmotor.md`. Dette er *kravgrunnlaget* (hvorfor + hva + suksesskriterier), ikke sesjonsplanen. +> +> **Kildeartefakter (i Maskinrommet-innholdsrepoet, ikke her):** `serier/silvija-seres-motsvar/HANDOVER.md §7`, `~/.claude/learnings/global-learnings.md` (2026-05-27), og `linkedin-plugin-endringsspec.md` (taktisk endringsliste — denne briefen er det strategiske laget over den). + +--- + +## 1. Problem / nordstjerne + +Å produsere **én kort artikkel** som er **100 % korrekt** *og* **treffer primærpersonaen** tok i praksis timer (Seres-serien Del 2). Det er ikke bærekraftig ved 3–7 artikler/uke. + +**Nordstjerne:** en kort artikkel fra idé til publiseringsklar på **~30 min**, uten å ofre korrekthet eller persona-treff. Målet er å *front-loade og systematisere* verifisering og dømmekraft — ikke å skippe dem. + +## 2. Evidensgrunnlag (hva som faktisk gikk galt) + +Del 2 ble først skrevet som en **modell-katalog** (det forfatteren fant interessant), passerte review, og var nær publisering før den ble stoppet og skrevet helt om. Tidstyvene, kategorisert: + +| Tidstyv | Type | Adresseres av | +|---|---|---| +| Dårlig utkast måtte skrives helt om | Skulle vært fanget | Blokkerende persona-gate (mål 1) | +| Persona-gaten flagget tung friksjon, men ble lest som notat | Prosess-svikt | Gate som stryk/bestått (mål 1) | +| Trippelsjekk av mange ferske påstander som egen sluttfase | Gjentakende | Påstands-ledger + verifisering ved skriving (mål 3) | +| Flere gale påstander i en *bedre* tekst (titler, «standarder», studie-funn, scope, årstall) | Gjentakende | Verifiseringsdisiplin (mål 3) | +| AI-slop / overhead / katalog-ras → mange ordpuss-runder | Gjentakende | Voice «unngå»-mønstre + mal (mål 2, 4) | +| Build ↔ kilde i utakt (footgun) | Repo-spesifikt | Allerede fikset i innholdsrepoet (ikke plugin) | + +**Tre tverklærdommer (skal styre designet):** +1. Persona-review må **blokkere**, ikke annotere. +2. Skriv for **leseren**, ikke forfatteren — ett konkret case > en katalog. +3. **Sterkere narrativ ≠ riktigere fakta** — verifiser mer, ikke mindre. + +## 3. Mål — hva den oppgraderte pluginen skal levere + +1. **Blokkerende persona-gate.** 3 personaer (A IT-dir, B KI-leder, **C linjeleder = primær, trumfer**) leser KUN teksten. Returnerer **BESTÅTT/STRYK**, ikke kommentarer. ⛔ Hard fail = C «mistet meg», C eier ikke handlingen, sjargong-mur, eller modell-/navne-katalog. «JA med forbehold» = NEI. Kjøres ett pass på nær-ferdig utkast. +2. **Voice «unngå»-mønstre i profilen.** Katalog-ras, fullstendighet-over-handling, selvrefererende overhead-åpninger, «ikke bare X, men Y», unødig tre-listing, påklistret oppsummering, hedging. Mål: utkastet treffer persona C på 1.–2. forsøk, ikke 5. +3. **Påstands-ledger + verifiseringsdisiplin.** Hver faktapåstand føres med kilde + dato *mens* teksten skrives. Påstander datert etter modellens kunnskapsgrense **må websøkes**. Fast sjekkliste for hyppige feiltyper: persontitler (sluttet/byttet rolle), «standarder» som varierer per virksomhet, studier tilskrevet for sterke funn, kilde-scope (konkludert vs. utenfor scope), start-/utgivelsesår. +4. **Artikkel-skjelett / mal.** Led med leserens problem; ett konkret (helst norsk) etterprøvbart case framfor en liste; lande på leser-eid handling; skill eksplisitt «dette eier du» vs. «dette ber du IT/fag om». + +## 4. Eierskap (hvem gjør hva) + +- **LTL-pluginen:** strategi, voice, hooks/caption, **persona-gate**, **påstands-ledger**, mal — alt som er innholds-/kvalitetsarbeid. +- **Voyage (trek*):** orkestrering av lengre/fler-sesjons-løp der det trengs. +- **Innholdsrepo (Maskinrommet):** produksjon/rendering (POST.html/PDF/carousel via `tools/`-scriptene). Render holdes utenfor pluginen. + +## 5. Ikke-mål (scope-grenser) + +- Ikke fjern menneskelig dømmekraft eller verifisering — målet er fart *med* korrekthet. +- Rendering/typografi forblir i innholdsrepoet. +- Analytics forblir CSV-basert (jf. eksisterende v1.3.0-beslutning — posting-only API). +- Denne briefen lager ikke 21-sesjonsplanen; den gir kravene planen skal innfri. + +## 6. Suksesskriterier (målbare) + +- [ ] Tid idé→publiseringsklar for en kort artikkel: **~30 min** (ned fra timer). +- [ ] Persona C gir **ekte JA** på 1.–2. pass (ikke «JA med forbehold»). +- [ ] **Null** uverifiserte påstander datert etter kunnskapsgrensen ved publisering. +- [ ] **Null** gale person-titler / falske «standard»-påstander / overdrevne studie-funn (de fem feiltypene i mål 3). +- [ ] Persona-gaten **blokkerer** dokumentert (stryk → omskriv før godkjenning), ikke bare annoterer. + +## 7. Åpne spørsmål / research-plan (start her i sesjon 1) + +- Kartlegg gjeldende plugin-struktur (v1.2.0: ~27 kommandoer, 16 agenter, 9 hooks, 6 skills) — hvor hører gate/ledger/mal hjemme (ny agent? skill-steg i `pipeline`/`post`? hook?). +- Hvordan formaliseres en *blokkerende* verdikt-retur i arbeidsflyten (agent → strukturert PASS/FAIL som stopper neste steg)? +- Ledger-format: nytt asset (`assets/claims/…`)? Knyttet til `differentiation-checker`/research? +- Sekvensering mot eksisterende v1.3.0-plan (posting-API) — uavhengig spor eller felles release? +- Verifiser at voice-profilen (`config/user-profile.local.md`) har en «unngå»-seksjon å utvide. + +--- + +*Skrevet fra produksjonserfaringen i Maskinrommet. Plugin-endringene utføres i LTL-repoet, ikke her.*