open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions
ktg-plugin-marketplace/plugins/linkedin-studio/docs/brief-maskinrommet-feltkunnskap.md
Kjell Tore Guttormsen b6bb61246b refactor(linkedin)!: rename plugin linkedin-thought-leadership → linkedin-studio (v3.0.0) 
BREAKING CHANGE: the marketplace slug, the agent namespace
(linkedin-studio:<agent>), and the runtime state-file path
(~/.claude/linkedin-studio.local.md) all change. Reinstall required;
existing state migrated in place (post metrics, streak, history preserved).
The /linkedin:* commands are unchanged — the command namespace is set
per-command in frontmatter and was always independent of the plugin slug.
Functionality is byte-identical to v2.4.0; this release is pure identity.

- dir + manifests: plugins/linkedin-studio + plugin.json + root marketplace.json
- agent namespace updated in commands/newsletter.md (only functional invoker)
- state path updated in 4 hook scripts + topic-rotation prompt + state template
- catch-all skill dir renamed skills/linkedin-studio (5 functional skills unchanged)
- docs + version bump to 3.0.0 across README badge, CHANGELOG, root README/CLAUDE.md
- historical records (CHANGELOG past entries, docs/ build artifacts,
  config-audit v5.0.0 snapshots) intentionally retain the old slug

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-29 11:32:02 +02:00

5.5 KiB
Raw Permalink Blame History

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.