From 9e5695286d7ee811933f6ebb5ad6000d94ce448b Mon Sep 17 00:00:00 2001 From: Kjell Tore Guttormsen Date: Sat, 20 Jun 2026 06:39:49 +0200 Subject: [PATCH] =?UTF-8?q?refactor(linkedin-studio):=20S29e=20terminology?= =?UTF-8?q?-scrub=20=E2=80=94=20rename=20thought-leadership-angles.md=20->?= =?UTF-8?q?=20content-angles.md=20+=20all=20pointers?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Final sub-pass of the S29 plugin-wide terminology scrub. The canonical reference file is renamed and every functional pointer updated atomically in one commit. The file's in-file title/headers were already FORM A-scrubbed in S29c (H1 reads "Content Angles"), so S29e is a pure rename + pointer update — no FORM A remained in the file. Rename: references/thought-leadership-angles.md -> references/content-angles.md (git mv). Pointers updated (17 files, 29 occurrences) — token "thought-leadership-angles" -> "content-angles": - references/ (2): ai-content-framework, glossary - agents/ (7): content-repurposer, strategy-advisor, network-builder, content-planner, trend-spotter, video-scripter, differentiation-checker - commands/ (6): pipeline, video, post, competitive, react, batch - skills/ (1): linkedin-content-creation/SKILL - docs/ (1, forward-looking): integration-test-guide Left URØRT per the standing S29 decision (history = honest record of a past state, not a runtime load): CHANGELOG.md, docs/hardening/log.md, docs/hardening/plan.md. STATE.md untouched here (rewritten at session end). Verify: no thought-leadership-angles* file remains; references/content-angles.md present; zero residual "thought-leadership-angles" in commands/agents/references/skills/integration-test-guide; structure gate scripts/test-runner.sh 81/0/0 exit 0. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_016qgzo6rxthw7KuxHjn5vyE --- agents/content-planner.md | 4 ++-- agents/content-repurposer.md | 4 ++-- agents/differentiation-checker.md | 2 +- agents/network-builder.md | 2 +- agents/strategy-advisor.md | 2 +- agents/trend-spotter.md | 2 +- agents/video-scripter.md | 6 +++--- commands/batch.md | 4 ++-- commands/competitive.md | 2 +- commands/pipeline.md | 4 ++-- commands/post.md | 6 +++--- commands/react.md | 2 +- commands/video.md | 4 ++-- docs/integration-test-guide.md | 2 +- references/ai-content-framework.md | 2 +- .../{thought-leadership-angles.md => content-angles.md} | 0 references/glossary.md | 4 ++-- skills/linkedin-content-creation/SKILL.md | 6 +++--- 18 files changed, 29 insertions(+), 29 deletions(-) rename references/{thought-leadership-angles.md => content-angles.md} (100%) diff --git a/agents/content-planner.md b/agents/content-planner.md index 75dccd6..c0f80af 100644 --- a/agents/content-planner.md +++ b/agents/content-planner.md @@ -29,7 +29,7 @@ Read these files before planning: ``` ${CLAUDE_PLUGIN_ROOT}/skills/linkedin-studio/SKILL.md → expertise areas, voice -${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md → 8 universal angles +${CLAUDE_PLUGIN_ROOT}/references/content-angles.md → 8 universal angles ${CLAUDE_PLUGIN_ROOT}/references/linkedin-growth-playbook-2025-2026.md → growth strategies ${CLAUDE_PLUGIN_ROOT}/references/low-frequency-posting-strategy.md → sustainable posting ${CLAUDE_PLUGIN_ROOT}/references/linkedin-formats.md → format options @@ -500,7 +500,7 @@ Ask via AskUserQuestion before creating issues: ## Reference Files -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` — 8 universal angles +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` — 8 universal angles - `${CLAUDE_PLUGIN_ROOT}/references/linkedin-growth-playbook-2025-2026.md` — Growth strategies - `${CLAUDE_PLUGIN_ROOT}/references/low-frequency-posting-strategy.md` — Sustainable posting - `${CLAUDE_PLUGIN_ROOT}/references/linkedin-formats.md` — Format options and specs diff --git a/agents/content-repurposer.md b/agents/content-repurposer.md index e7fc940..54ad266 100644 --- a/agents/content-repurposer.md +++ b/agents/content-repurposer.md @@ -34,7 +34,7 @@ ${CLAUDE_PLUGIN_ROOT}/references/linkedin-formats.md → format spe ${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md → CTA and engagement patterns ${CLAUDE_PLUGIN_ROOT}/references/articles-strategy-guide.md → article writing strategy ${CLAUDE_PLUGIN_ROOT}/references/newsletter-strategy-guide.md → newsletter integration -${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md → 8 universal angles +${CLAUDE_PLUGIN_ROOT}/references/content-angles.md → 8 universal angles ${CLAUDE_PLUGIN_ROOT}/assets/case-studies/case-study-template.md → case study structure + 4 LinkedIn post angles ${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/examples/high-engagement-posts.md → proven patterns to replicate ~/.claude/linkedin-studio.local.md → user state + performance data @@ -614,5 +614,5 @@ Create the `drafts/repurposed/` directory if it doesn't exist. - `${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md` — CTA patterns - `${CLAUDE_PLUGIN_ROOT}/references/articles-strategy-guide.md` — article strategy - `${CLAUDE_PLUGIN_ROOT}/references/newsletter-strategy-guide.md` — newsletter integration -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` — 8 universal angles +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` — 8 universal angles - `${CLAUDE_PLUGIN_ROOT}/references/low-frequency-posting-strategy.md` — posting cadence diff --git a/agents/differentiation-checker.md b/agents/differentiation-checker.md index d3fe96a..18d716f 100644 --- a/agents/differentiation-checker.md +++ b/agents/differentiation-checker.md @@ -324,6 +324,6 @@ content-planner --> [draft] --> differentiation-checker --> content-optimizer -- ## References Read these files for detailed methodology: -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` -- 8 Universal Angles, combinations, red flags, authority value test +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` -- 8 Universal Angles, combinations, red flags, authority value test - `${CLAUDE_PLUGIN_ROOT}/references/ai-content-framework.md` -- AI content anti-patterns, differentiation checklist, relevance filter - `${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md` -- hook types, contrarian opening patterns, story structures diff --git a/agents/network-builder.md b/agents/network-builder.md index 0339931..c0c1108 100644 --- a/agents/network-builder.md +++ b/agents/network-builder.md @@ -708,4 +708,4 @@ Activity: - `${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md` — engagement methods - `${CLAUDE_PLUGIN_ROOT}/references/linkedin-growth-playbook-2025-2026.md` — growth strategies - `${CLAUDE_PLUGIN_ROOT}/references/opportunity-generation.md` — conversion and DM strategy -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` — angles for comments +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` — angles for comments diff --git a/agents/strategy-advisor.md b/agents/strategy-advisor.md index e1d6e1f..7474f63 100644 --- a/agents/strategy-advisor.md +++ b/agents/strategy-advisor.md @@ -456,5 +456,5 @@ Time: [time] Read these files for detailed methodology: - `${CLAUDE_PLUGIN_ROOT}/references/growth-roadmaps.md` - `${CLAUDE_PLUGIN_ROOT}/references/low-frequency-posting-strategy.md` -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` - `${CLAUDE_PLUGIN_ROOT}/references/troubleshooting-guide.md` diff --git a/agents/trend-spotter.md b/agents/trend-spotter.md index 4de339b..299d1ab 100644 --- a/agents/trend-spotter.md +++ b/agents/trend-spotter.md @@ -361,7 +361,7 @@ Search 6: "[AI debate OR controversy OR opinion] LinkedIn [this week]" ## References Read these files for detailed methodology: -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` - 8 universal angles, selection framework, combination patterns +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` - 8 universal angles, selection framework, combination patterns - `${CLAUDE_PLUGIN_ROOT}/references/ai-content-framework.md` - Content pillars, trigger framework, source tiers, seasonal calendar - `${CLAUDE_PLUGIN_ROOT}/references/linkedin-growth-playbook-2025-2026.md` - Trend Translator tactic, first-mover advantage - `${CLAUDE_PLUGIN_ROOT}/references/algorithm-signals-reference.md` - Engagement signals and profile/topic-relevance validation diff --git a/agents/video-scripter.md b/agents/video-scripter.md index 67fb003..3e4570a 100644 --- a/agents/video-scripter.md +++ b/agents/video-scripter.md @@ -33,7 +33,7 @@ Read these files for video scripting intelligence: ${CLAUDE_PLUGIN_ROOT}/references/video-strategy-guide.md → Script templates, pacing, production guidance ${CLAUDE_PLUGIN_ROOT}/references/linkedin-formats.md → Video specs, algorithm data, technical requirements ${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md → Hook types, CTAs, story structures -${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md → 8 universal angles +${CLAUDE_PLUGIN_ROOT}/references/content-angles.md → 8 universal angles ${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/voice-samples/ → User's authentic voice (ALWAYS read before scripting) ${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/examples/high-engagement-posts.md → Successful content patterns ~/.claude/linkedin-studio.local.md → User state, recent topics, streak @@ -76,7 +76,7 @@ Default recommendation: **60 seconds** — 2026 sweet spot. LinkedIn requires 30 Follow the same pattern as post creation: 1. Identify the core insight or message -2. Read `references/thought-leadership-angles.md` +2. Read `references/content-angles.md` 3. Present 2-3 angle options via AskUserQuestion 4. Check against recent topics in state file to avoid repetition 5. Verify topic alignment with user's 5 core expertise areas @@ -236,5 +236,5 @@ Update state in `~/.claude/linkedin-studio.local.md`: - `${CLAUDE_PLUGIN_ROOT}/references/video-strategy-guide.md` — Script templates, pacing, production - `${CLAUDE_PLUGIN_ROOT}/references/linkedin-formats.md` — Video specs, algorithm, technical requirements - `${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md` — Hook types, CTAs -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` — 8 universal angles +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` — 8 universal angles - `${CLAUDE_PLUGIN_ROOT}/references/first-comment-strategy.md` — First comment timing and tactics diff --git a/commands/batch.md b/commands/batch.md index c37ffba..4b4c4fc 100644 --- a/commands/batch.md +++ b/commands/batch.md @@ -40,7 +40,7 @@ Use AskUserQuestion: 3. **Use existing plan** — Follow the weekly plan already created 4. **Mix it up** — Diverse topics across pillars -If they choose a theme, help them identify 3-5 unique angles from `references/thought-leadership-angles.md`. For timely angles, delegate to the `trend-spotter` agent — invoke it via `Task` with `subagent_type: linkedin-studio:trend-spotter` (foreground, from this command layer) — to surface trending topics and score their relevance against the user's pillars. +If they choose a theme, help them identify 3-5 unique angles from `references/content-angles.md`. For timely angles, delegate to the `trend-spotter` agent — invoke it via `Task` with `subagent_type: linkedin-studio:trend-spotter` (foreground, from this command layer) — to surface trending topics and score their relevance against the user's pillars. ## Step 2: Plan the Batch (with Scheduling) @@ -203,7 +203,7 @@ Each scheduled post has a 15-minute reminder before posting time. ## Reference Files -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` - `${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md` - `${CLAUDE_PLUGIN_ROOT}/references/low-frequency-posting-strategy.md` - `${CLAUDE_PLUGIN_ROOT}/references/scheduling-strategy.md` diff --git a/commands/competitive.md b/commands/competitive.md index 4c5e0f5..f12dc92 100644 --- a/commands/competitive.md +++ b/commands/competitive.md @@ -158,6 +158,6 @@ Emphasize: The goal is inspiration and differentiation, NOT copying. Always find ## Reference Files -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` - `${CLAUDE_PLUGIN_ROOT}/references/linkedin-growth-playbook-2025-2026.md` - `${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md` diff --git a/commands/pipeline.md b/commands/pipeline.md index 220156f..eff4b54 100644 --- a/commands/pipeline.md +++ b/commands/pipeline.md @@ -52,7 +52,7 @@ To situate the post in the broader plan — does it fill a content-mix gap or re Once topic is chosen, create the draft: -1. **Select angle** — Auto-select the strongest angle from `references/thought-leadership-angles.md` based on topic and user's expertise. Present ONE recommended angle with reasoning. Do NOT use AskUserQuestion — just proceed. If user disagrees, offer alternatives. +1. **Select angle** — Auto-select the strongest angle from `references/content-angles.md` based on topic and user's expertise. Present ONE recommended angle with reasoning. Do NOT use AskUserQuestion — just proceed. If user disagrees, offer alternatives. 2. **Infer format** — Default to text post. Only mention carousel/video as a note if particularly well-suited. 3. **Write draft** — Following the structure: - Hook: 110-140 characters @@ -201,7 +201,7 @@ Replace placeholders with actual post data. Set `next_planned_topic` manually if ## Reference Files -- `${CLAUDE_PLUGIN_ROOT}/references/thought-leadership-angles.md` +- `${CLAUDE_PLUGIN_ROOT}/references/content-angles.md` - `${CLAUDE_PLUGIN_ROOT}/references/engagement-frameworks.md` - `${CLAUDE_PLUGIN_ROOT}/references/algorithm-signals-reference.md` - `${CLAUDE_PLUGIN_ROOT}/references/linkedin-formats.md` diff --git a/commands/post.md b/commands/post.md index bf06acf..d5064e4 100644 --- a/commands/post.md +++ b/commands/post.md @@ -63,9 +63,9 @@ If they provide a URL, use WebFetch to extract the content first. ## Step 2: Select Content Angle -Read `references/thought-leadership-angles.md` for the 8 universal angles. +Read `references/content-angles.md` for the 8 universal angles. -**Industry-specific angles:** If `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/profile/user-profile.md` exists and has an `industry` field, check the "Industry Angle Variants" section in `thought-leadership-angles.md` for the matching industry table. Use the industry-specific starter questions and example hooks to generate more targeted angle suggestions. +**Industry-specific angles:** If `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/profile/user-profile.md` exists and has an `industry` field, check the "Industry Angle Variants" section in `content-angles.md` for the matching industry table. Use the industry-specific starter questions and example hooks to generate more targeted angle suggestions. Select the strongest angle based on the content and user's expertise areas. Present ONE recommended angle with brief reasoning: @@ -200,7 +200,7 @@ Replace placeholders with actual post data. This replaces manual YAML editing. ## Reference Files -- `references/thought-leadership-angles.md` - 8 universal angles +- `references/content-angles.md` - 8 universal angles - `references/engagement-frameworks.md` - Hooks, structure, CTAs - `references/linkedin-formats.md` - Format specifications - `references/algorithm-signals-reference.md` - Algorithm mechanics diff --git a/commands/react.md b/commands/react.md index d2d3939..9772eb8 100644 --- a/commands/react.md +++ b/commands/react.md @@ -270,6 +270,6 @@ Same as Step 8 — run `state-updater.mjs` with actual post data. ## Reference Files - `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/voice-samples/authentic-voice-samples.md` — Voice matching -- `references/thought-leadership-angles.md` — 8 universal angles +- `references/content-angles.md` — 8 universal angles - `references/engagement-frameworks.md` — Hooks, structure, CTAs - `assets/checklists/quality-scorecard.md` — Pre-publish check diff --git a/commands/video.md b/commands/video.md index 89abd86..47a2085 100644 --- a/commands/video.md +++ b/commands/video.md @@ -73,7 +73,7 @@ Default recommendation: **60 seconds** is the 2026 sweet spot — shorter videos Follow the same flow as `/linkedin:post`: 1. Ask what they want the video to be about (if not already clear) -2. Read `references/thought-leadership-angles.md` for the 8 universal angles +2. Read `references/content-angles.md` for the 8 universal angles 3. Present 2-3 angle options via AskUserQuestion 4. Verify topic doesn't duplicate recent posts (check state file) 5. Confirm topic aligns with user's 5 core expertise areas @@ -233,6 +233,6 @@ Replace placeholders with actual post data. This replaces manual YAML editing. - `references/video-strategy-guide.md` — Script templates, pacing, production - `references/linkedin-formats.md` — Video specs, algorithm, technical requirements - `references/engagement-frameworks.md` — Hook types, CTAs -- `references/thought-leadership-angles.md` — 8 universal angles +- `references/content-angles.md` — 8 universal angles - `references/algorithm-signals-reference.md` — Algorithm mechanics - `assets/checklists/quality-scorecard.md` — Pre-publish check diff --git a/docs/integration-test-guide.md b/docs/integration-test-guide.md index ec9caf2..3be64bf 100644 --- a/docs/integration-test-guide.md +++ b/docs/integration-test-guide.md @@ -20,7 +20,7 @@ Before testing, ensure: 1. Run `/linkedin:pipeline` 2. Verify Step 0 loads: state file read, status displayed (posts/week, streak) 3. Choose "Generate ideas for me" when prompted -4. Verify 3 topic suggestions appear, drawn from `thought-leadership-angles.md` +4. Verify 3 topic suggestions appear, drawn from `content-angles.md` 5. Select a topic → verify angle selection (2-3 options) 6. Choose format → verify draft follows structure (hook/context/insight/implication/CTA) 7. Verify optimization checks run: diff --git a/references/ai-content-framework.md b/references/ai-content-framework.md index d215e9d..d03cda1 100644 --- a/references/ai-content-framework.md +++ b/references/ai-content-framework.md @@ -379,7 +379,7 @@ Before posting AI content: This framework integrates with the main LinkedIn content skill: -- **Angles:** AI content uses same 8 angles (thought-leadership-angles.md) +- **Angles:** AI content uses same 8 angles (content-angles.md) - **Formats:** Follow format guidelines in linkedin-formats.md - **Engagement:** Apply same engagement frameworks - **Growth:** Contributes to overall authority building diff --git a/references/thought-leadership-angles.md b/references/content-angles.md similarity index 100% rename from references/thought-leadership-angles.md rename to references/content-angles.md diff --git a/references/glossary.md b/references/glossary.md index 4c193a1..7285bc0 100644 --- a/references/glossary.md +++ b/references/glossary.md @@ -28,7 +28,7 @@ Signal triggers that correlate with lower reach: excessive hashtags, external li ### Angle Rotation Systematic application of 8 universal content angles across the same topic to create distinct post variations without repeating yourself. The 8 angles: Contrarian Take, Pattern Recognition, Uncomfortable Truth, Future Implication, Personal Lesson, Reframe, Practical Breakdown, Human Story. -**Used in:** `references/thought-leadership-angles.md`, `agents/content-planner.md`, `agents/trend-spotter.md` +**Used in:** `references/content-angles.md`, `agents/content-planner.md`, `agents/trend-spotter.md` ### Authority Score Composite metric measuring a creator's established expertise on a topic, derived from posting consistency, engagement quality, profile alignment (topic-relevance), and network validation. Higher authority unlocks broader distribution. @@ -229,7 +229,7 @@ Penalty state where posts reach only immediate connections without algorithmic a ### Authority Value Test Three-question quality gate before publishing: (1) Does this help someone make a better decision? (2) Does this change how someone thinks? (3) Would I find this valuable if someone else wrote it? Must pass all three. -**Used in:** `references/thought-leadership-angles.md`, `agents/differentiation-checker.md`, `agents/trend-spotter.md` +**Used in:** `references/content-angles.md`, `agents/differentiation-checker.md`, `agents/trend-spotter.md` ### Topical Consistency Posting about consistent topics within demonstrated expertise areas. The algorithm learns your domain expertise over 30+ days. Gaps >5 days trigger -15-25% reach penalty on return. diff --git a/skills/linkedin-content-creation/SKILL.md b/skills/linkedin-content-creation/SKILL.md index f4251b1..6843822 100644 --- a/skills/linkedin-content-creation/SKILL.md +++ b/skills/linkedin-content-creation/SKILL.md @@ -74,7 +74,7 @@ Identify what type of raw material the user has: ### Step 2: Identify Content Angles -Read `references/thought-leadership-angles.md` to understand the 8 universal angles for any content. +Read `references/content-angles.md` to understand the 8 universal angles for any content. **For the user's input, identify 2-3 possible angles:** 1. Which angle best fits their content? @@ -190,7 +190,7 @@ The Content Matrix creates 40+ post ideas through systematic combination. - Document (PDF) **Axis 2: The 8 Content Angles** -(See `references/thought-leadership-angles.md`) +(See `references/content-angles.md`) - Contrarian Take - Pattern Recognition - Uncomfortable Truth @@ -287,7 +287,7 @@ For full scoring system, see `assets/checklists/quality-scorecard.md`. | File | When to Read | |------|--------------| -| `references/thought-leadership-angles.md` | Choosing post angle | +| `references/content-angles.md` | Choosing post angle | | `references/engagement-frameworks.md` | Writing hooks, CTAs | | `references/linkedin-formats.md` | Choosing format | | `references/url-processing-templates.md` | Converting external content |