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>
This commit is contained in:
parent
9df3de795c
commit
b6bb61246b
196 changed files with 164 additions and 138 deletions
160
plugins/linkedin-studio/docs/brief-fullspektrum-innholdsmotor.md
Normal file
160
plugins/linkedin-studio/docs/brief-fullspektrum-innholdsmotor.md
Normal file
|
|
@ -0,0 +1,160 @@
|
|||
# Brief — LTL som fullspektrum LinkedIn-innholdsmotor (idé → publisering)
|
||||
|
||||
> **Til:** linkedin-studio-pluginens utviklingsrepo.
|
||||
> **Skrevet:** 2026-05-26, etter produksjon av den første kronikkserien (Seres-serien, 6 deler).
|
||||
> **Type:** retningsbrief — beslutningsgrunnlag før planlegging/bygging. Selvstendig (kan leses uten annen kontekst).
|
||||
|
||||
---
|
||||
|
||||
## 1. Hva vi skal oppnå
|
||||
|
||||
Løft LTL fra en kortform-fokusert plugin til **den komplette motoren for ALT LinkedIn-innhold,
|
||||
fra idé til publisering** — inkludert **nyhetsbrev/langform**, som i dag er pluginens svakeste område.
|
||||
|
||||
Én plugin skal eie hele kjeden: **idé → research → utkast → faktasjekk → review → hook/distribusjon →
|
||||
planlegging → publisering → analyse** — for alle formater: posts, carousels, reaksjoner, video, og
|
||||
**nyhetsbrev-editions**.
|
||||
|
||||
Begrunnelsen: scopet er LinkedIn. Da hører nyhetsbrev hjemme i LTL (det ER et LinkedIn-native format),
|
||||
sømmene mot en separat plugin koster mer enn de gir, og brukeren bruker uansett LTL for alt LinkedIn.
|
||||
|
||||
---
|
||||
|
||||
## 2. Kontekst: hvor dette innholdet lages
|
||||
|
||||
**`~/repos/maskinrommet`** er det private, lokale repoet der **ALT innhold produseres**. Der brukes
|
||||
**LTL-pluginen til all innholdsproduksjon**. Arbeidsdelingen:
|
||||
|
||||
- **maskinrommet** = arbeidsbenken (innhold, serier, og en delt `tools/`-mappe med deterministiske
|
||||
render-skript: `build-linkedin.mjs` → POST.html, `build-carousel.mjs`, `build-html.mjs` annoterbar
|
||||
HTML, `build-pdf.mjs` avis-PDF).
|
||||
- **LTL** = verktøyet/hjernen som driver produksjonen i det repoet.
|
||||
- **dette LTL-repoet** = der selve plugin-utviklingen skjer. Erfaringene kommer fra maskinrommet;
|
||||
endringene gjøres her.
|
||||
|
||||
Render-skriptene i `maskinrommet/tools/` er den mekaniske utføreren som LTL-pipelinen *kaller*.
|
||||
«LTL eier prosessen» krever ikke at LTL *hoster* render-skriptet — se åpen beslutning C.
|
||||
|
||||
---
|
||||
|
||||
## 3. Live-status (baseline å bygge for)
|
||||
|
||||
Nyhetsbrevet **Maskinrommet** er etablert på LinkedIn:
|
||||
- **Første post ute**, **30 abonnenter**, **6 nyhetsbrev i pipen** (Seres-serien, ferdig produsert).
|
||||
- Publisering er manuell (LinkedIn har ingen API for newsletter/long-form), men kan native-planlegges.
|
||||
|
||||
Dette er en reell, kjørende kadens — ikke en hypotese. Forbedringene skal støtte å produsere de neste
|
||||
seriene raskere og med samme kvalitet.
|
||||
|
||||
---
|
||||
|
||||
## 4. Erfaringsgrunnlag: hva en kronikk faktisk krever
|
||||
|
||||
Seres-serien (6 kronikker, ~10 sesjoner) avdekket at langform-produksjon ikke er «skriving» — det er en
|
||||
**research- og adversarial-review-pipeline**. Den faktiske flyten som ga kvalitet:
|
||||
|
||||
1. **Brief** — vinkel, tenkt stemme, målgruppe-personaer (med primær), nøkkelpoeng, tone, leder-takeaway.
|
||||
2. **Research** — flere parallelle, avgrensede mandater → verifiserte notater.
|
||||
3. **Faktasjekk-sweep** — risikosortert (🔴/🟡/🟢), parallelle WebSearch-agenter, «hver påstand skyldig
|
||||
til motbevist». Fanget ~13 feil — flere som egne research-filer hadde bommet på.
|
||||
4. **Skriving** — dramaturgisk rekkefølge, multi-sesjon med vedlikeholdt HANDOVER.
|
||||
5. **Konsistens + kvalitet** — på tvers av tekstene (gjentakelser, tone, premiss→konklusjon-bue).
|
||||
6. **Persona-/audience-sweep FØR lås** — 3 definerte leser-juryer leser read-only, primær trumfer.
|
||||
(«Lander poenget?»). Kjørt til konvergens (LØST/DELVIS/IKKE per flagg).
|
||||
7. **Hook-/konverterings-gate** — egen persona-gate på distribusjons-teksten: «ville DU klikket?»,
|
||||
hold tilbake leveransen (tall/case/grep), ikke konklusjonen.
|
||||
8. **Lås → leveranse** — POST.html «alt på ett sted» (dato, hook, hashtags, første kommentar,
|
||||
cover-caption, brødtekst som rik tekst).
|
||||
|
||||
**De tre suksessfaktorene:** front-loadet kontekst, skreddersydd annoteringsverktøy, vedlikeholdt
|
||||
single-source HANDOVER før hver kontekst-reset.
|
||||
|
||||
**Største prosessfeil å unngå:** persona-sweep ble kjørt ETTER lås → måtte åpne låste tekster. Den
|
||||
generaliserte malen MÅ ha persona-sweep FØR lås.
|
||||
|
||||
---
|
||||
|
||||
## 5. Byggeprinsipp: løft Voyage-mønstrene, ikke fork dem
|
||||
|
||||
Denne pipelinen mapper nesten 1:1 på **Voyage**-pluginen (trekbrief → trekresearch → trekplan →
|
||||
trekexecute → trekreview, med parallelle agenter + adversarielle reviewere + multi-sesjon).
|
||||
|
||||
**Men IKKE fork Voyage og IKKE reimplementer den blindt.** Voyage er kode-spesifikk (`file:line`,
|
||||
kode-reviewere, RULE_CATALOGUE). Løft i stedet **mønstrene** inn i LTL som et nytt **langform-/
|
||||
nyhetsbrev-spor** ved siden av de eksisterende kortform-kommandoene:
|
||||
|
||||
- faset pipeline med parallelle research-agenter
|
||||
- faktasjekk-sweep som eget steg
|
||||
- multi-persona adversarial jury (leser-personaer erstatter kode-reviewere; primær trumfer)
|
||||
- multi-sesjons-kontinuitet (HANDOVER-mønster)
|
||||
|
||||
**Delte agenter, variabel intensitet:** research- og faktasjekk-agentene skal kunne kalles på *lav*
|
||||
intensitet fra en kortform-post som siterer ett tall, og *full* sweep fra et nyhetsbrev. Voice og
|
||||
hook-gate deles på tvers — aldri to systemer.
|
||||
|
||||
Voyage er **referanse/inspirasjon**, ikke en avhengighet å vedlikeholde.
|
||||
|
||||
---
|
||||
|
||||
## 6. Hva LTL allerede har (ikke bygg på nytt)
|
||||
|
||||
- Skrive-workflows for kortform: `/linkedin:post` (vinkel→draft→kvalitet→refinement),
|
||||
`/linkedin:pipeline` (idé→draft→optimer→planlegg→engasjer→publiser→analyse), `batch`, `react`,
|
||||
`quick`, `carousel`, `video`, `templates`.
|
||||
- Voice-system (`config/user-profile.local.md`, voice-samples, voice-trainer-agent).
|
||||
- Hook-/optimaliserings-støtte (content-optimizer, differentiation-checker).
|
||||
- Planlegging/sporing/analyse (`calendar`, `publish`, `import`, `report`; queue.json; state-fil).
|
||||
- 16 agenter, fler-stegs-kommandoer, REMEMBER-kontinuitet — arkitekturen *kan* være vert for et tyngre
|
||||
pipeline-spor.
|
||||
|
||||
---
|
||||
|
||||
## 7. Gapet å fylle (LTLs svake punkt = langform/nyhetsbrev)
|
||||
|
||||
1. **Langform-/nyhetsbrev-pipeline** som eget kommandospor (idé→publisering for editions, ikke bare posts).
|
||||
2. **Research-orkestrering** — parallelle mandater, verifiserte notater.
|
||||
3. **Faktasjekk-sweep** — risikosortert, kildekritisk, verifiseringslogg, «skyldig til motbevist».
|
||||
4. **Multi-persona adversarial review FØR lås** — konfigurerbare leser-juryer, primær trumfer,
|
||||
konvergens-loop til rent JA.
|
||||
5. **Multi-sesjons-kontinuitet** — HANDOVER-mønster for produksjon som spenner flere økter.
|
||||
6. **Nyhetsbrev-leveranse** — edition-format (POST.html-stil «alt på ett sted»), delingstekst-system,
|
||||
ferskvare-flagg for tidssensitive tall, native planlegging.
|
||||
7. **Annoteringssteg** — integrer annoterbar review-HTML i flyten (render bor i maskinrommet/tools).
|
||||
|
||||
---
|
||||
|
||||
## 8. Åpne beslutninger (landes før bygging i dette repoet)
|
||||
|
||||
- **A. Pipeline som nye kommandoer vs. utvidelse av `pipeline`.** Eget `/linkedin:longform`/`:newsletter`-
|
||||
spor, eller utvid eksisterende `pipeline` med en «long-form»-modus?
|
||||
- **B. Agent-deling.** Bygges research/faktasjekk/persona-jury som nye delte agenter brukt på variabel
|
||||
intensitet av både kort- og langform? (Anbefalt.)
|
||||
- **C. Render-eierskap.** Forblir `build-linkedin.mjs`/`build-carousel.mjs` i `maskinrommet/tools/`
|
||||
(LTL kaller dem), eller flyttes LinkedIn-render inn i pluginen? (Anbefalt: bli i tools/ — render-familien
|
||||
deler fonts/identitet; pluginen holdes lean.)
|
||||
- **D. Personasett.** Defineres leser-personaene per prosjekt (fra målgruppen) eller som gjenbrukbare
|
||||
profiler i config?
|
||||
- **E. Faktasjekk-omfang.** Eget steg, eller integrert i research + review?
|
||||
|
||||
---
|
||||
|
||||
## 8b. Merknad: brukeren trenger onboarding i pluginen
|
||||
|
||||
Brukeren kjenner ikke pluginen sin godt ennå og vil «ta ut potensialet». Tilby tidlig i
|
||||
LTL-sesjonen: **`/linkedin`** (oversikt over alle kommandoer) + **`/linkedin:setup`**
|
||||
(personaliserings-score + fyll inn voice-samples/case/rammeverk/demografi/profil). Personalisering
|
||||
er nøkkelen — voice-matching, differensiering og hook-gate avhenger av ekte innmatede data.
|
||||
|
||||
## 9. Referanser (i `~/repos/maskinrommet` og memory)
|
||||
|
||||
- **Plan (supersedes-kandidat):** `~/repos/maskinrommet/planer/2026-05-26-kronikk-voyage-companion.md`
|
||||
— skrevet før denne retningen (foreslo separat companion). Behold som historikk; *denne briefen* er
|
||||
gjeldende retning.
|
||||
- **Erfaringskatalog:** produsert i sesjon 2026-05-26 (16 prosessfaser, suksessfaktorer, friksjon, verktøy).
|
||||
- **HANDOVER:** `~/repos/maskinrommet/serier/silvija-seres-motsvar/HANDOVER.md` (§3 leveranse, §4 regler, §5 metode).
|
||||
- **Memory (`~/.claude/projects/-Users-ktg-repos-svv/memory/`):**
|
||||
`project_kronikk_produksjonsprosess.md` (Voyage-mapping, persona-sweep-FØR-lås, kalibrering),
|
||||
`project_maskinrommet_newsletter.md`, `project_kronikk_faktasjekk_sweep.md`,
|
||||
`feedback_dokumentprosjekt_suksessfaktorer.md`, `feedback_hook_post_persona_gate.md`,
|
||||
`feedback_persona_audience_sweep.md`, `feedback_use_linkedin_plugin.md`,
|
||||
`feedback_post_html_single_sheet.md`.
|
||||
Loading…
Add table
Add a link
Reference in a new issue