From 72f2e8f6c933c49dd88a037e769a9bc8d36c765a Mon Sep 17 00:00:00 2001 From: Kjell Tore Guttormsen Date: Sat, 11 Apr 2026 01:01:13 +0200 Subject: [PATCH] docs(linkedin): update documentation for v1.2.0 friction reduction release MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Version bump v1.1.0 → v1.2.0 across all docs (CLAUDE.md, README.md, root README.md, plugin.json, CHANGELOG.md). Documents new scripts (state-updater, clipboard-helper, ical-generator), reduced interactive steps, auto-clipboard, progressive onboarding, and MCP carousel pipeline. Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 2 +- README.md | 4 ++-- .../.claude-plugin/plugin.json | 2 +- .../linkedin-thought-leadership/CHANGELOG.md | 19 +++++++++++++++++++ plugins/linkedin-thought-leadership/CLAUDE.md | 12 ++++++++++-- plugins/linkedin-thought-leadership/README.md | 17 ++++++++++++++++- 6 files changed, 49 insertions(+), 7 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 684d8e5..7deb084 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,7 +8,7 @@ Open-source Claude Code plugin marketplace. Solo project by Kjell Tore Guttormse plugins/ ai-psychosis/ v1.0.0 — Interaction awareness (sycophancy, reinforcement loops) config-audit/ v3.0.1 — Configuration intelligence (health, opportunities, auto-fix) - linkedin-thought-leadership/ v1.1.0 — LinkedIn content pipeline + analytics + linkedin-thought-leadership/ v1.2.0 — LinkedIn content pipeline + analytics llm-security/ v6.0.0 — Security scanning, auditing, threat modeling ms-ai-architect/ v1.8.0 — Microsoft AI architecture (Cosmo Skyberg persona) okr/ v1.0.0 — OKR guidance for Norwegian public sector diff --git a/README.md b/README.md index 13b6fc3..0eff951 100644 --- a/README.md +++ b/README.md @@ -117,11 +117,11 @@ Key commands: `/architect`, `/architect:ros`, `/architect:security`, `/architect --- -### [LinkedIn Thought Leadership](plugins/linkedin-thought-leadership/) `v1.1.0` +### [LinkedIn Thought Leadership](plugins/linkedin-thought-leadership/) `v1.2.0` Build authentic LinkedIn authority through algorithmic understanding, strategic consistency, and AI-assisted content creation. -Updated for the January 2026 360Brew algorithm change, which validates your creator profile before distributing content. v1.1.0 adds guided onboarding, carousel posts, multi-URL comparison, voice drift scoring, industry-specific content angles, and month-over-month analytics. +Updated for the January 2026 360Brew algorithm change, which validates your creator profile before distributing content. v1.2.0 reduces friction: auto-clipboard on all content commands, max 2 interactive steps per post, deterministic state management, MCP image carousel pipeline, progressive onboarding, and iCal calendar integration for batch scheduling. - **Guided onboarding** — `/linkedin:onboarding` walks new users through profile → setup → first post in one flow - **360Brew profile optimization** — audit your profile against LinkedIn's creator validation criteria diff --git a/plugins/linkedin-thought-leadership/.claude-plugin/plugin.json b/plugins/linkedin-thought-leadership/.claude-plugin/plugin.json index 8d18d06..44b2a80 100644 --- a/plugins/linkedin-thought-leadership/.claude-plugin/plugin.json +++ b/plugins/linkedin-thought-leadership/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "linkedin-thought-leadership", - "version": "1.1.0", + "version": "1.2.0", "description": "Build LinkedIn thought leadership with algorithmic understanding, strategic consistency, and authentic engagement. Updated for the January 2026 360Brew algorithm change.", "author": { "name": "Kjell Tore Guttormsen" diff --git a/plugins/linkedin-thought-leadership/CHANGELOG.md b/plugins/linkedin-thought-leadership/CHANGELOG.md index 8283ac1..7ca267a 100644 --- a/plugins/linkedin-thought-leadership/CHANGELOG.md +++ b/plugins/linkedin-thought-leadership/CHANGELOG.md @@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [1.2.0] - 2026-04-11 + +### Summary +Friction reduction release. Fewer interactive steps, auto-clipboard, deterministic state management, and progressive onboarding. + +### Added +- **`clipboard-helper.mjs`** — cross-platform clipboard utility (macOS `pbcopy`, Linux `xclip`/`xsel`, WSL `clip.exe`). All 8 content commands auto-copy output to clipboard +- **`state-updater.mjs`** — deterministic state mutations: `updatePostTracking`, `pruneContentHistory`, `updateFollowerCount`. Pure functions with 19 tests. No AI involvement in state updates +- **`ical-generator.mjs`** — RFC 5545 calendar file generation for batch scheduling. VALARM reminders, VTIMEZONE support, line folding, special character escaping. 16 tests +- **MCP image carousel pipeline** — `/linkedin:carousel` generates professional slide images via mcp-image (1080x1350, 3:4 ratio) with text overlays. Mermaid Chart and text-based fallbacks +- **Progressive onboarding** — personalization score hidden until 3+ posts; voice guardian suppressed until 5+ voice samples; reasonable defaults in state template +- **iCal integration in batch** — `/linkedin:batch` generates `.ics` file importable into macOS Calendar, Google Calendar, and Outlook +- **Auto-prune content history** — session-start dynamically imports `pruneContentHistory` to remove entries older than 90 days + +### Changed +- **Reduced interactive steps** — angle, format, and post type inferred from context. Max 2 questions per post (down from 4-6) in `post`, `quick`, `react`, `pipeline` +- **State management** — Stop hook and 8 commands now reference `state-updater.mjs` for deterministic writes instead of AI-driven YAML editing +- **State file template** — default expertise area changed from domain-specific to `"general"` for better new-user experience + ## [1.1.0] - 2026-04-08 ### Summary diff --git a/plugins/linkedin-thought-leadership/CLAUDE.md b/plugins/linkedin-thought-leadership/CLAUDE.md index 2d67c5e..866c0f4 100644 --- a/plugins/linkedin-thought-leadership/CLAUDE.md +++ b/plugins/linkedin-thought-leadership/CLAUDE.md @@ -1,10 +1,13 @@ -# LinkedIn Thought Leadership Plugin (v1.1.0) +# LinkedIn Thought Leadership Plugin (v1.2.0) Build LinkedIn thought leadership with algorithmic understanding, strategic consistency, and authentic engagement. January 2026 360Brew algorithm update integrated. ## 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) @@ -23,12 +26,16 @@ Build LinkedIn thought leadership with algorithmic understanding, strategic cons | `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`. +**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 (27) +All content commands (post, quick, react, pipeline, first-post, video, multiplatform, carousel) 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. + | Command | Purpose | |---------|---------| | `/linkedin` | Router — status line + command menu | @@ -90,3 +97,4 @@ Build LinkedIn thought leadership with algorithmic understanding, strategic cons 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 diff --git a/plugins/linkedin-thought-leadership/README.md b/plugins/linkedin-thought-leadership/README.md index d862f23..2bb72a1 100644 --- a/plugins/linkedin-thought-leadership/README.md +++ b/plugins/linkedin-thought-leadership/README.md @@ -4,7 +4,7 @@ *Built for my own Claude Code workflow and shared openly for anyone who finds it useful. This is a solo project — bug reports and feature requests are welcome, but pull requests are not accepted.* -![Version](https://img.shields.io/badge/version-1.1.0-blue) +![Version](https://img.shields.io/badge/version-1.2.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) @@ -18,6 +18,7 @@ A comprehensive Claude Code plugin that turns LinkedIn from a chore into a syste ## Table of Contents +- [What's New in v1.2.0](#whats-new-in-v120) - [What Is This?](#what-is-this) - [Quick Start](#quick-start) - [Commands](#commands) @@ -36,6 +37,19 @@ A comprehensive Claude Code plugin that turns LinkedIn from a chore into a syste --- +## What's New in v1.2.0 + +**Friction reduction release** — fewer steps, faster output, smarter defaults. + +- **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 + +--- + ## What Is This? This plugin gives you a complete LinkedIn thought leadership system inside Claude Code. Instead of staring at a blank post editor, you work through structured workflows that handle ideation, drafting, optimization, scheduling, publishing, and post-publish analytics — all calibrated to how LinkedIn's algorithm actually works. @@ -503,6 +517,7 @@ Scheduled posts are tracked in `assets/drafts/queue.json`: | Version | Date | Highlights | |---------|------|-----------| +| **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. | | **0.6.0** | 2026-02-07 | First formal version. 20 commands, 15 agents, 8 hooks, analytics system, 360Brew profile optimization, content matrix system, personalization engine, 20 reference documents. |