Kjell Tore Guttormsen
2a27a7cd6a
Two new pipeline phases gate the spine before any prose is written: - Step 2.5 — Skeleton + section pitch: writes <serie>/NN-skjelett.md with the five-line spine (premiss / problem / anbefaling / gevinst / vei videre) + one-line section pitches. Operator-gate (JA / REVIDER / NEI) AND parallel persona-skjelett-sweep must both return JA before the pipeline can advance. - Step 3a — Spine prose: one paragraph per section against the gated skeleton, ~20-30% of final edition length. Operator-gate on whether the axis lands now that there is prose on it. Old Step 3 (Draft) split into 3a (spine) and 3b (full expansion); 3b owns the multi-session draft-cursor logic. Third persona-reviewer mode added: skjelett (alongside resonans + konverter). Five spine axes scored HOLDER / TVILER / MANGLER, max 3 direction-only flags, per-pitch section-pay-in check. Reads the skeleton + pitches only. Pipeline grows from 11 to 13 phases; commands (24) and agents (14) counts unchanged. Encodes the Maskinrommet writing-contract section A discipline (premiss / problem / anbefaling / gevinst / vei videre) into the pipeline. Empirically motivated by the Seres-serien Del 3 + Del 4 production: a spine error caught at the skeleton stage costs 5-15 min, the same error caught at Step 6 (resonance) costs 4-12 h, post-lock it costs a day of cascading rework (delingstekst, hooks, carousel, doc refs). Backward-compatible: existing editions stop at currentPhase: "research" and now resume at Step 2.5 instead of Step 3 — an intended deterministic improvement, never a contract break. Steps 1, 2, 4-10 bit-for-bit unchanged. Renderers (build-html.mjs, build-linkedin.mjs) untouched. New phase strings in edition-state.template.json _doc.phases: - skeleton-pitch (between research and draft) - spine-prose (between skeleton-pitch and draft) Files changed (10): - plugin.json: 2.0.0 -> 2.1.0 - CHANGELOG.md: new [2.1.0] entry - CLAUDE.md (plugin + marketplace): pipeline 11->13 phases noted - README.md (plugin + marketplace): What's New v2.1.0 + version row - agents/persona-reviewer.md: third mode skjelett added; resonans + konverter unchanged - commands/newsletter.md: Step 2.5 + 3a + 3b sections, resumption + pipeline tables - config/edition-state.template.json: 11 -> 13 phases in _doc.phases - references/longform-quality-rules.md: Rule 8 (Skjelett foer prosa) Verification: 9/9 criteria PASS pre-commit. Phase strings consistent across template + command + resumption table. Renderer files git-untouched. All 11 original step headings preserved (Step 0/1/2/4-10). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
104 lines
8.3 KiB
Markdown
104 lines
8.3 KiB
Markdown
# LinkedIn Thought Leadership Plugin (v2.1.0)
|
|
|
|
Full-spectrum LinkedIn content engine — short-form feed posts, carousels, video scripts, and long-form newsletter editions — with the January 2026 360Brew algorithm baked in. v2.0.0 consolidated the surface (27 commands → 24, 16 agents → 14) while adding the long-form `/linkedin:newsletter` orchestrator + two longform-quality gate agents (`fact-checker`, `persona-reviewer`). **v2.1.0** adds two new gates BEFORE prose to `/linkedin:newsletter` — Step 2.5 (skeleton + section pitch with operator-gate + persona-skjelett-sweep) and Step 3a (spine prose with operator-gate) — plus a third `persona-reviewer` mode (`skjelett`), encoding the Maskinrommet writing-contract §A discipline (premiss / problem / anbefaling / gevinst / vei videre) into the pipeline itself. Pipeline grows from 11 to 13 phases; commands and agents unchanged in count (24, 14).
|
|
|
|
## Architecture
|
|
|
|
- **State file:** `~/.claude/linkedin-thought-leadership.local.md` (YAML frontmatter, auto-initialized from `config/state-file.template.md`)
|
|
- **State updater:** `hooks/scripts/state-updater.mjs` — deterministic state mutations (post tracking, streak, content history pruning). Pure functions, tested, no AI involvement
|
|
- **Clipboard helper:** `hooks/scripts/clipboard-helper.mjs` — cross-platform clipboard integration (macOS `pbcopy`, Linux `xclip`/`xsel`, WSL `clip.exe`). All content commands auto-copy to clipboard
|
|
- **iCal generator:** `hooks/scripts/ical-generator.mjs` — RFC 5545 calendar file generation for batch scheduling. Standalone CLI + importable module
|
|
- **Post queue:** `assets/drafts/queue.json` (managed by `hooks/scripts/queue-manager.mjs`)
|
|
- **Analytics CLI:** `scripts/analytics/` (TypeScript, requires `tsx` and `npm install`)
|
|
- **Analytics data:** `assets/analytics/` (gitignored)
|
|
|
|
## Hooks
|
|
|
|
9 hooks across 7 events. All Node.js (.mjs). PreToolUse/PostToolUse hooks use parameterized `content-gatekeeper.mjs` with `isLinkedInContent()` check.
|
|
|
|
| Event | Purpose |
|
|
|-------|---------|
|
|
| `SessionStart` | Load state, REMEMBER.md, milestone tracker |
|
|
| `PreToolUse` (Write\|Edit) | Content quality gate, voice guardian, topic rotation gate |
|
|
| `Stop` | State update, pre-publish reminders, content history |
|
|
| `UserPromptSubmit` | LinkedIn context enrichment (three-tier matching) |
|
|
| `PostToolUse` (Write) | Post-creation automation (5x5x5, posting time) |
|
|
| `PreCompact` | Preserve LinkedIn context during compaction |
|
|
| `Notification` | Posting reminders (rate-limited 30min) |
|
|
|
|
**Session markers:** `/tmp/linkedin-hooks/session-active` (Stop hook gating, 12h staleness). **Shared modules:** `linkedin-content-filter.mjs`, `queue-manager.mjs`, `personalization-score.mjs`, `state-updater.mjs`, `clipboard-helper.mjs`.
|
|
|
|
**State updates:** Post tracking, streak management, and content history are handled deterministically by `state-updater.mjs` (called from Stop hook and commands). Content history entries older than 90 days are auto-pruned at session start.
|
|
|
|
**Hook editing:** Edit `hooks/hooks.template.json` + `hooks/prompts/*.md`, then run `python3 hooks/scripts/compile-hooks.py`. Do not edit `hooks.json` directly. Prompts are loaded at runtime by gatekeeper scripts; the compile step is only needed when adding `type: prompt` hooks.
|
|
|
|
## Commands (24)
|
|
|
|
All content commands (post, quick, react, pipeline, first-post, video, multiplatform, carousel, newsletter) auto-copy output to clipboard via `clipboard-helper.mjs`. Interactive steps are minimized — angle, format, and post type are inferred from context, with max 2 questions per post. **v2.0.0 net change:** 5 commands removed (`templates`, `publish`, `authority`, `collab`, `speaking` — absorbed into `quick`, `calendar`, `strategy`, `outreach` respectively) + 2 commands added (`newsletter`, `outreach`) = 27 → 24.
|
|
|
|
| Command | Purpose |
|
|
|---------|---------|
|
|
| `/linkedin` | Router — status line + command menu |
|
|
| `/linkedin:onboarding` | Multi-step onboarding wizard (profile → setup → first-post) |
|
|
| `/linkedin:first-post` | First-post accelerator (10 min) |
|
|
| `/linkedin:setup` | Guided personalization setup |
|
|
| `/linkedin:react` | URL-to-post pipeline |
|
|
| `/linkedin:post` | Full post creation (10-15 min) |
|
|
| `/linkedin:quick` | 5-minute quick post (3-line formula) + 8 post-type templates |
|
|
| `/linkedin:pipeline` | Full end-to-end content pipeline |
|
|
| `/linkedin:newsletter` | Long-form orchestrator: newsletter edition / essay / series article — multi-session 13-phase pipeline with **skeleton + spine-prose gates BEFORE prose (v2.1)** and fact-check + persona-sweep BEFORE lock |
|
|
| `/linkedin:batch` | Create a full week of content |
|
|
| `/linkedin:calendar` | View/manage post scheduling queue + publish action (mark scheduled posts as published) |
|
|
| `/linkedin:carousel` | Structured multi-slide carousel generator |
|
|
| `/linkedin:video` | Video script generator (30s-2min) |
|
|
| `/linkedin:multiplatform` | Adapt content for other platforms (short-form/cross-format; long-form → `/linkedin:newsletter`) |
|
|
| `/linkedin:analyze` | Content/performance analysis |
|
|
| `/linkedin:audit` | Periodic content strategy audit |
|
|
| `/linkedin:import` | Import CSV export → structured JSON (delegates analysis to `/linkedin:report`) |
|
|
| `/linkedin:report` | Generate weekly performance report |
|
|
| `/linkedin:ab-test` | Design and manage A/B content tests |
|
|
| `/linkedin:strategy` | Growth strategy + authority building (phase guidance, trajectory, signature content compounding) |
|
|
| `/linkedin:competitive` | Competitive analysis of niche |
|
|
| `/linkedin:monetize` | Monetization strategy and funnels (unlocks at ~1K followers) |
|
|
| `/linkedin:outreach` | Outreach orchestrator — collaborations + speaking opportunities (unlocks at ~1K followers) |
|
|
| `/linkedin:profile` | 360Brew profile optimization |
|
|
|
|
## Agents (14)
|
|
|
|
| Agent | Model | Color | Responsibility |
|
|
|-------|-------|-------|----------------|
|
|
| `content-optimizer` | Sonnet | Blue | Optimize existing posts |
|
|
| `strategy-advisor` | Sonnet | Green | Growth recommendations |
|
|
| `analytics-interpreter` | Sonnet | Yellow | Audience pattern analysis + weekly/monthly performance reports (interpret/report modes) |
|
|
| `engagement-coach` | Sonnet | Magenta | 5x5x5 + first-hour tactics + CEA commenting + target selection |
|
|
| `content-planner` | Sonnet | Cyan | Content audit + weekly/monthly plans |
|
|
| `network-builder` | Sonnet | Teal | Strategic networking + outreach |
|
|
| `content-repurposer` | Sonnet | Purple | Format conversion + evergreen refresh |
|
|
| `trend-spotter` | Sonnet | White | Trending topics + opportunity scores |
|
|
| `voice-trainer` | Sonnet | Pink | Voice profile building + drift detection |
|
|
| `differentiation-checker` | Sonnet | Gray | Originality scoring + commodity detection |
|
|
| `post-feedback-monitor` | Haiku | Lime | Post-publish 48h monitoring |
|
|
| `video-scripter` | Sonnet | Violet | Video script creation with pacing |
|
|
| `fact-checker` | Opus | Brown | Factual-claim verification against primary sources (longform) |
|
|
| `persona-reviewer` | Opus | Olive | Reader-persona skeleton (v2.1, before prose) + resonance (before lock) + hook-conversion (after lock) gate (longform) |
|
|
|
|
**Rule:** Always read `assets/voice-samples/` before generating content.
|
|
|
|
**Invocation form:** Commands invoke plugin agents by their **namespaced** type —
|
|
`subagent_type: linkedin-thought-leadership:<name>` — never the bare `<name>` (a bare
|
|
type does not resolve and the `Task` call fails).
|
|
|
|
**Reload requirement:** Adding a NEW agent file under `agents/` registers it only after
|
|
a Claude Code **session reload** — the plugin agent set is built at session start, so a
|
|
freshly-added agent (e.g. `fact-checker`, `persona-reviewer` when first added) is not
|
|
invokable until the session reloads. After adding an agent, reload before invoking it.
|
|
|
|
## Content Quality Rules
|
|
|
|
1. Hook: 110-140 characters (mobile cutoff)
|
|
2. Post length: 1,200-1,800 chars (standard), 150-500 chars (quick)
|
|
3. No external links in post body (40-50% reach suppression)
|
|
4. No corporate buzzwords: leverage, synergy, paradigm shift, thought leader, disruptive, value proposition, ecosystem, holistic approach
|
|
5. Topic must align with user's 5 core expertise areas (360Brew signal)
|
|
6. Topic rotation: no back-to-back same pillar, no pillar >50% in 14 days (warn-only)
|
|
7. Progressive onboarding: personalization score hidden until 3+ posts; voice guardian suppressed until 5+ voice samples
|