Kjell Tore Guttormsen
36ad116e43
Krav fra produksjonserfaring (Seres-serien): blokkerende persona-gate, voice unngaa-moenstre, paastands-ledger + verifiseringsdisiplin, artikkel-skjelett. Komplementaer til brief-fullspektrum-innholdsmotor.md. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
71 lines
5.5 KiB
Markdown
71 lines
5.5 KiB
Markdown
# 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.*
|