ktg-plugin-marketplace/plugins/linkedin-thought-leadership/docs/agents-capability-matrix.md
Kjell Tore Guttormsen 92e0a0b4f5 fix(linkedin): close dogfood friction (S14)
Close all 9 friction points from the S13 newsletter dogfood (operator
elected to fix F6-F9 rather than defer):

- F1: namespace all subagent_type calls in newsletter.md to
  linkedin-thought-leadership:<name> (4 sites + canonical note)
- F2: document agent invocation form + reload requirement in CLAUDE.md
  + README.md (reload itself is an operator action)
- F3: add edition-config / edition-delingstekst / edition-HANDOVER
  templates under config/ + wire into Steps 0 and 8 + footer
- F4: reconcile draft path to <serie>/NN-utkast.md (series root)
- F5: de-hardcode series root (explicit arg / LTL_SERIES_ROOT / default)
- F6: config-derive carousel editions (remove Seres CAROUSEL set);
  correct samle comment
- F7: build-html.mjs exits non-zero when zero HTML produced
- F8: guard parseDelingstekst (graceful ENOENT) + correct Step 8 wording
- F9: relocate agents/README.md -> docs/agents-capability-matrix.md

Re-tested: 87/87 plugin tests pass; build-html/build-linkedin behavior
re-verified live. Per-item outcomes logged in dogfood-S13-friction.md.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 23:37:39 +02:00

158 lines
10 KiB
Markdown

# Agent Capability Matrix
16 specialized agents for LinkedIn thought leadership. Each agent has a focused responsibility, defined model, and unique color for visual identification.
## Quick Reference
| Agent | Model | Color | Primary Responsibility |
|-------|-------|-------|----------------------|
| content-optimizer | Sonnet | Blue | Optimize posts against algorithm signals |
| strategy-advisor | Sonnet | Green | Growth strategy and phase-specific guidance |
| analytics-interpreter | Sonnet | Yellow | Pattern discovery from analytics data |
| engagement-coach | Haiku | Magenta | 5x5x5 method and engagement routines |
| content-planner | Sonnet | Cyan | Weekly/monthly content calendars |
| performance-reporter | Sonnet | Amber | Weekly/monthly performance reports |
| network-builder | Sonnet | Teal | Strategic networking and outreach |
| content-repurposer | Sonnet | Purple | Format conversion and evergreen refresh |
| comment-strategist | Sonnet | Red | CEA commenting and target selection |
| trend-spotter | Sonnet | White | Trending topics and opportunity scoring |
| voice-trainer | Sonnet | Pink | Voice profile building and drift detection |
| differentiation-checker | Sonnet | Gray | Originality scoring and commodity detection |
| video-scripter | Sonnet | Violet | Video script creation with pacing and visual cues |
| post-feedback-monitor | Haiku | Lime | Post-publish 48h monitoring and real-time interventions |
| fact-checker | Opus | Brown | Factual-claim verification against primary/credible sources (longform) |
| persona-reviewer | Opus | Olive | Reader-persona resonance + hook-conversion gate (longform) |
## Capability Matrix
Capabilities mapped across agents. **P** = Primary, **S** = Secondary/Supporting.
| Capability | optimizer | strategy | analytics | engage | planner | tracker | perf-rep | network | repurpose | comment | trends | voice | diff-check | video | post-monitor | pers-scorer |
|-----------|:---------:|:--------:|:---------:|:------:|:-------:|:-------:|:--------:|:-------:|:---------:|:-------:|:------:|:-----:|:----------:|:-----:|:------------:|:-----------:|
| Post optimization | **P** | | | | | | | | | | | | | | | |
| Hook analysis | **P** | | | | | | | | | | | | | S | | |
| Algorithm alignment | **P** | | | S | | | | | | | | | | S | S | |
| Growth strategy | | **P** | | | S | | | | | | | | | | | |
| Phase assessment | | **P** | | | | | | | | | | | | | | |
| Trajectory analysis | | **P** | S | | | | S | | | | | | | | | |
| Audience analysis | | S | **P** | | | | S | | | | | | | | | |
| Pattern discovery | | | **P** | | | | S | | | | | | | | | |
| Trend analysis | | | S | | | | **P** | | | | | | | | | |
| Engagement coaching | | | | **P** | | | | S | | S | | | | | | |
| 5x5x5 method | | | | **P** | | | | S | | S | | | | | | |
| Content planning | | | | | **P** | | | | | | S | | | | | |
| Mix enforcement | | | | | **P** | | | | | | | | | | | |
| Gap analysis | | | | | **P** | S | | | | | | | | | | |
| Accountability | | | | | | **P** | S | | | | | | | | | |
| Plan tracking | | | | | | **P** | | | | | | | | | | |
| Performance reports | | | S | | | S | **P** | | | | | | | | | |
| Content DNA | | | | | | | **P** | | | | | S | | | | |
| Network building | | | | S | | | | **P** | | | | | | | | |
| Connection scoring | | | | | | | | **P** | | | | | | | | |
| DM templates | | | | | | | | **P** | | | | | | | | |
| Format conversion | | | | | | | | | **P** | | | | | S | | |
| Evergreen scoring | | | | | | | | | **P** | | | | | | | |
| Content lifecycle | | | | | S | | | | **P** | | | | | | | |
| Comment strategy | | | | S | | | | | | **P** | | | | | | |
| CEA method | | | | S | | | | | | **P** | | | | | | |
| Target identification | | | | | | | | S | | **P** | | | | | | |
| Trend scanning | | | | | S | | | | | | **P** | | | | | |
| First-mover assessment | | | | | | | | | | | **P** | | | | | |
| Angle mapping | | | | | S | | | | S | | **P** | | | | | |
| Voice profiling | | | | | | | | | | | | **P** | | | | |
| Drift detection | | | | | | | | | | | | **P** | | | | |
| Quarterly audit | | | | | | | | | | | | **P** | | | | |
| Originality scoring | | | | | | | | | | | | | **P** | | | |
| Commodity detection | | | | | | | | | | | | | **P** | | | |
| Differentiation | | | | | | | | | | | | | **P** | | | |
| Video scripting | | | | | | | | | S | | | | | **P** | | |
| Script pacing | | | | | | | | | | | | | | **P** | | |
| Visual cue notation | | | | | | | | | | | | | | **P** | | |
| Post-publish monitoring | | | | | | | | | | | | | | | **P** | |
| Velocity analysis | | | | | | | | | | | | | | | **P** | |
| Asset completeness | | | | | | | | | | | | | | | | **P** |
| Setup recommendations | | | | | | | | | | | | | | | | **P** |
## Content Pipeline
How agents collaborate in the end-to-end content lifecycle:
```
┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ trend-spotter│───▸│ content-planner │───▸│ diff-checker │
│ (find topics)│ │ (plan + schedule) │ │ (originality │
└─────────────┘ └──────────────────┘ │ gate ≥51/100) │
│ └────────┬────────┘
│ │
┌──────▼──────┐ ┌───────┴────────┐
│voice-trainer│ │ FORMAT SPLIT │
│(voice check)│ └──┬──────────┬──┘
└──────┬──────┘ │ │
│ ┌───────▼───┐ ┌────▼─────────┐
│ │video- │ │content- │
└────────────▸│scripter │ │optimizer │
│(scripts) │ │(text posts) │
└───────┬───┘ └──────┬───────┘
│ │
└─────┬──────┘
┌────────────────────────────┤
│ │
┌──────▼────────────┐ ┌────────▼───────┐
│performance-reporter│ │ [PUBLISH] │
│(weekly/monthly) │ └────────┬───────┘
└───────────────────┘ │
┌────────▼───────┐
│engagement-coach│
│(5x5x5 + first │
│ hour tactics) │
└──────┬─────────┘
┌──────▼─────────┐
│comment-strategist
│(CEA commenting) │
└────────────────┘
```
### Parallel Support Agents
These agents operate independently and feed into the pipeline at multiple points:
```
strategy-advisor ──────▸ Macro-level planning and phase guidance
analytics-interpreter ─▸ Pattern discovery feeding back into planning
network-builder ───────▸ Relationship building amplifying content reach
content-repurposer ────▸ Post-publish: extends content lifecycle
```
## Which Agent Do I Need?
| Scenario | Agent | Command |
|----------|-------|---------|
| "I want to write a post" | content-optimizer | `/linkedin:post` |
| "What should I post about?" | content-planner, trend-spotter | `/linkedin:pipeline` |
| "Make this post better" | content-optimizer | `/linkedin:post` |
| "Is this original enough?" | differentiation-checker | `/linkedin:pipeline` |
| "Plan my week's content" | content-planner | `/linkedin:batch` |
| "Am I on track this week?" | — | `/linkedin:calendar` |
| "How did I do this week?" | performance-reporter | `/linkedin:report` |
| "Analyze my LinkedIn data" | analytics-interpreter | `/linkedin:analyze` |
| "What's my LinkedIn strategy?" | strategy-advisor | `/linkedin:strategy` |
| "Help me engage more" | engagement-coach | `/linkedin:strategy` |
| "Who should I comment on?" | comment-strategist | `/linkedin:strategy` |
| "Build my network" | network-builder | `/linkedin:strategy` |
| "Does this sound like me?" | voice-trainer | `/linkedin:post` |
| "Repurpose my best post" | content-repurposer | `/linkedin:pipeline` |
| "What's trending in my field?" | trend-spotter | `/linkedin:pipeline` |
| "Audit my content strategy" | analytics-interpreter, strategy-advisor | `/linkedin:audit` |
| "How do I monetize?" | strategy-advisor | `/linkedin:monetize` |
| "Create a video script" | video-scripter | `/linkedin:video` |
| "Turn this post into a video" | video-scripter, content-repurposer | `/linkedin:video` |
| "Script a talking head video" | video-scripter | `/linkedin:video` |
## Model Selection Rationale
| Model | Agents | Why |
|-------|--------|-----|
| **Opus** | 2 agents (fact-checker, persona-reviewer) | Longform judgment: factual verification, reader-persona resonance |
| **Sonnet** | 12 agents | Complex reasoning: optimization, strategy, analysis, scoring, scripting |
| **Haiku** | 2 agents (engagement-coach, post-feedback-monitor) | Lighter tasks: coaching prompts, post monitoring |