chore(linkedin): v2.0.0 — import trim, router gating, full doc pass (S20)

This commit is contained in:
Kjell Tore Guttormsen 2026-05-28 06:53:55 +02:00
commit 8de481399e
12 changed files with 146 additions and 108 deletions

View file

@ -6,21 +6,21 @@
*AI-generated: all code produced by Claude Code through dialog-driven development. [Full disclosure →](../../README.md#ai-generated-code-disclosure)*
![Version](https://img.shields.io/badge/version-1.2.0-blue)
![Version](https://img.shields.io/badge/version-2.0.0-blue)
![Platform](https://img.shields.io/badge/platform-Claude_Code_Plugin-purple)
![Commands](https://img.shields.io/badge/commands-27-green)
![Agents](https://img.shields.io/badge/agents-16-orange)
![Commands](https://img.shields.io/badge/commands-24-green)
![Agents](https://img.shields.io/badge/agents-14-orange)
![Hooks](https://img.shields.io/badge/hooks-9-red)
![Reference Docs](https://img.shields.io/badge/reference_docs-24-teal)
![License](https://img.shields.io/badge/license-MIT-lightgrey)
A comprehensive Claude Code plugin that turns LinkedIn from a chore into a system. It covers the full content lifecycle — from ideation and drafting through publishing, analytics, and growth strategy — with 27 slash commands, 16 specialized agents, 9 automated hooks, and a 24-document knowledge base grounded in LinkedIn's actual algorithm signals. Updated for the January 2026 **360Brew** algorithm change, where LinkedIn now validates your profile before distributing content.
A comprehensive Claude Code plugin that turns LinkedIn from a chore into a full-spectrum content engine — short-form feed posts, carousels, video scripts, and long-form newsletter editions. v2.0.0 consolidated the surface (27 → 24 commands, 16 → 14 agents) and added `/linkedin:newsletter` as a multi-session long-form orchestrator with fact-check + persona-sweep gates BEFORE lock. 24 slash commands, 14 specialized agents, 9 automated hooks, and a 24-document knowledge base grounded in LinkedIn's actual algorithm signals. Updated for the January 2026 **360Brew** algorithm change, where LinkedIn now validates your profile before distributing content.
---
## Table of Contents
- [What's New in v1.2.0](#whats-new-in-v120)
- [What's New in v2.0.0](#whats-new-in-v200)
- [What Is This?](#what-is-this)
- [Quick Start](#quick-start)
- [Commands](#commands)
@ -39,16 +39,23 @@ A comprehensive Claude Code plugin that turns LinkedIn from a chore into a syste
---
## What's New in v1.2.0
## What's New in v2.0.0
**Friction reduction release** — fewer steps, faster output, smarter defaults.
**Full-spectrum content engine** — feed posts AND long-form newsletter editions in one cohesive surface, with net-fewer commands.
- **Auto-clipboard** — All 8 content commands (`post`, `quick`, `react`, `pipeline`, `first-post`, `video`, `multiplatform`, `carousel`) automatically copy finished content to your clipboard. No more manual copy-paste
- **Reduced interactive steps** — Angle, format, and post type are inferred from context. Maximum 2 questions per post (down from 4-6)
- **Deterministic state management** — Post tracking, streak updates, and content history are handled by `state-updater.mjs` (pure functions, tested, no AI involved). Content history auto-prunes entries older than 90 days
- **MCP image carousel pipeline**`/linkedin:carousel` can generate professional slide images via mcp-image with text overlays (1080x1350, 3:4 ratio). Falls back to Mermaid diagrams or text-based slides
- **Progressive onboarding** — New users see a cleaner experience: personalization score hidden until 3+ posts, voice guardian suppressed until 5+ voice samples
- **iCal calendar integration**`/linkedin:batch` generates an `.ics` file importable into macOS Calendar, Google Calendar, or Outlook. Each post gets a calendar event with reminders
- **Long-form `/linkedin:newsletter` orchestrator** — multi-session pipeline (load → calibrate → research fan-out → draft → consistency → fact-check sweep → persona sweep → lock → delivery → hook-gate → schedule) with maintained edition-state across sessions. Supports newsletter editions, essays, and series articles
- **Two new longform-quality gate agents**`fact-checker` (Opus, verifies every factual claim against primary sources) and `persona-reviewer` (Opus, evaluates reader-persona resonance + hook-conversion). Both run BEFORE lock — the cost of fixing an error in a published edition is too high
- **Render pipeline migrated into the plugin**`render/build-html.mjs`, `build-pdf.mjs`, `build-linkedin.mjs`, `build-carousel.mjs` + self-hosted fonts (Newsreader, Inter, JetBrains Mono) under OFL-1.1. No more cross-repo render dependency
- **Persona library**`config/personas.template.md` lets you define reader personas with knowledge level, time-pressure, and resonance criteria. `persona-reviewer` uses these to evaluate every long-form draft
- **Edition-state schema**`assets/editions/<slug>/state.json` tracks a long-form piece across many sessions (research notes, draft revisions, fact-check status, persona-review status, lock state)
- **Net surface reduction** — 27 → 24 commands (5 removed: `templates`, `publish`, `authority`, `collab`, `speaking` absorbed into existing commands; 2 added: `newsletter`, `outreach`). 16 → 14 agents (4 merged: `content-tracker`, `personalization-scorer`, `performance-reporter`, `comment-strategist` absorbed into `analytics-interpreter` + `engagement-coach`; 2 added: `fact-checker`, `persona-reviewer`)
- **Analytics consolidation**`analytics-interpreter` now has interpret + report modes (replaces standalone `performance-reporter`); `engagement-coach` now owns 5x5x5 + first-hour tactics + CEA commenting + target selection + daily routine (replaces standalone `comment-strategist`)
- **`/linkedin:import` analysis delegates to `/linkedin:report`** — both consume the same `trends` CLI; the import flow runs the report inline instead of duplicating the analysis pipeline
- **Router gating**`/linkedin:monetize` and `/linkedin:outreach` now surface "unlocks at ~1K followers" guidance so new creators are pointed at `/linkedin:strategy` first
### Friction reduction (carried forward from prior release)
- Auto-clipboard on all content commands · max 2 interactive steps · deterministic `state-updater.mjs` · MCP image carousel · progressive onboarding · iCal calendar integration
---
@ -124,7 +131,7 @@ The wizard handles everything: 360Brew profile checklist, voice and user profile
## Commands
All 26 commands use colon notation: `/linkedin:post`, `/linkedin:quick`, etc.
All 24 commands use colon notation: `/linkedin:post`, `/linkedin:quick`, etc.
### Onboarding
@ -284,10 +291,10 @@ Six domain-specific skills organize the plugin's knowledge and route commands to
| Skill | Domain | Commands Routed |
|-------|--------|-----------------|
| `linkedin-thought-leadership` | Router + shared knowledge (algorithm, quality rules) | `/linkedin`, `/linkedin:setup` |
| `linkedin-content-creation` | Posts, templates, batch, pipeline, video, calendar | `/linkedin:post`, `:quick`, `:templates`, `:pipeline`, `:batch`, `:calendar`, `:publish`, `:video`, `:multiplatform` |
| `linkedin-content-creation` | Posts, batch, pipeline, video, calendar, newsletter | `/linkedin:post`, `:quick`, `:pipeline`, `:batch`, `:calendar`, `:video`, `:multiplatform`, `:newsletter`, `:carousel` |
| `linkedin-analytics` | Analysis, reporting, import, A/B testing | `/linkedin:analyze`, `:audit`, `:import`, `:report`, `:ab-test` |
| `linkedin-strategy` | Growth, authority, competitive, monetization | `/linkedin:strategy`, `:authority`, `:competitive`, `:monetize` |
| `linkedin-networking` | Engagement, collaborations, speaking | `/linkedin:outreach` |
| `linkedin-strategy` | Growth, authority (absorbed), competitive, monetization | `/linkedin:strategy`, `:competitive`, `:monetize` |
| `linkedin-networking` | Engagement, collaborations, speaking (all in `outreach`) | `/linkedin:outreach` |
| `linkedin-voice` | Voice training, profile optimization, differentiation | `/linkedin:profile` |
---
@ -523,6 +530,7 @@ Scheduled posts are tracked in `assets/drafts/queue.json`:
| Version | Date | Highlights |
|---------|------|-----------|
| **2.0.0** | 2026-05-28 | Full-spectrum content engine. `/linkedin:newsletter` long-form orchestrator with multi-session edition-state, fact-check + persona-sweep gates BEFORE lock. New agents: `fact-checker`, `persona-reviewer` (both Opus). Render pipeline migrated in-plugin with self-hosted OFL-1.1 fonts. Net-fewer surface: 27 → 24 commands (5 removed, 2 added), 16 → 14 agents (4 merged, 2 added). Router gating on monetize/outreach (unlocks at ~1K). `/linkedin:import` delegates analysis to `/linkedin:report`. |
| **1.2.0** | 2026-04-11 | Friction reduction release. Auto-clipboard on all content commands, reduced interactive steps (max 2 per post), deterministic state management (`state-updater.mjs`), MCP image carousel pipeline, progressive onboarding, iCal calendar integration for batch scheduling, auto-prune content history (90 days). |
| **1.1.0** | 2026-04-08 | Q2 feature release. 27 commands (+onboarding, +carousel). Week-rollover automation, voice drift scoring, industry content matrix, multi-URL react, day-of-week heatmap, month-over-month reports. |
| **1.0.0** | 2026-04-07 | Public release. 25 commands, 16 agents, 9 hooks, 6 skills, 24 reference docs. Agent model tiering (Sonnet/Haiku), all scripts Node.js, comprehensive documentation. |