linkedin-studio/docs/agents-capability-matrix.md
Kjell Tore Guttormsen a8e3cacee3 feat(linkedin-studio): N5 — /linkedin:trends discovery-kommando + trend-spotter pin-fjerning + triage [skip-docs]
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: b69d02cd-d30d-478b-95a5-bd06113c648a
2026-07-17 04:00:17 +02:00

174 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Agent Capability Matrix
19 specialized agents for LinkedIn content (short-form feed + long-form newsletter). 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 + weekly/monthly performance reports (interpret/report modes) |
| engagement-coach | Sonnet | Magenta | 5x5x5 + first-hour tactics + CEA commenting + target selection |
| content-planner | Sonnet | Cyan | Weekly/monthly content calendars |
| network-builder | Sonnet | Teal | Strategic networking and outreach |
| content-repurposer | Sonnet | Purple | Format conversion and evergreen refresh |
| trend-spotter | (inherits session) | 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 | Opus | Lime | Post-publish 48h monitoring and real-time interventions |
| fact-checker | Opus | Brown | Factual-claim verification against primary/credible sources (longform) |
| editorial-reviewer | Opus | Orange | Editor's craft gate: prosa-håndverk + narrativ-arkitektur (longform) |
| persona-reviewer | Opus | Olive | Reader-persona skeleton + resonance + hook-conversion gate (longform) |
| voice-scrubber | Opus | Red | De-AI scrub + Norwegian-chronicle voice-drift correction (longform) |
| content-reviewer | Opus | Maroon | Cold argument-integrity review (C1C5) on a frozen draft (longform) |
| language-reviewer | Opus | Navy | Cold Norwegian-language review (L1L5) on a frozen draft (longform) |
| fact-reviewer | Opus | Gold | Cold fact re-verification (F1F4) + pivot-risk on a frozen draft (longform) |
## Capability Matrix
Capabilities mapped across the 14 content-production agents (the columns below). **P** = Primary, **S** = Secondary/Supporting. The five remaining agents — editorial-reviewer, voice-scrubber, content-reviewer, language-reviewer, fact-reviewer — are ordered long-form quality gates rather than content-capability agents; they are documented in **Longform Quality Gates** below and listed in the Quick Reference above.
| Capability | optimizer | strategy | analytics | engage | planner | network | repurpose | trends | voice | diff-check | video | post-monitor | fact-check | persona-rev |
|-----------|:---------:|:--------:|:---------:|:------:|:-------:|:-------:|:---------:|:------:|:-----:|:----------:|:-----:|:------------:|:----------:|:-----------:|
| Post optimization | **P** | | | | | | | | | | | | | |
| Hook analysis | **P** | | | | | | | | | | S | | | S |
| Algorithm alignment | **P** | | | S | | | | | | | S | S | | |
| Growth strategy | | **P** | | | S | | | | | | | | | |
| Phase assessment | | **P** | | | | | | | | | | | | |
| Trajectory analysis | | **P** | S | | | | | | | | | | | |
| Audience analysis | | S | **P** | | | | | | | | | | | |
| Pattern discovery | | | **P** | | | | | | | | | | | |
| Performance reports | | | **P** | | | | | | | | | | | |
| Content DNA | | | **P** | | | | | | S | | | | | |
| Engagement coaching | | | | **P** | | S | | | | | | | | |
| 5x5x5 method | | | | **P** | | S | | | | | | | | |
| Comment strategy | | | | **P** | | | | | | | | | | |
| CEA method | | | | **P** | | | | | | | | | | |
| Target identification | | | | **P** | | S | | | | | | | | |
| Content planning | | | | | **P** | | | S | | | | | | |
| Mix enforcement | | | | | **P** | | | | | | | | | |
| Gap analysis | | | | | **P** | | | | | | | | | |
| Network building | | | | S | | **P** | | | | | | | | |
| Connection scoring | | | | | | **P** | | | | | | | | |
| DM templates | | | | | | **P** | | | | | | | | |
| Format conversion | | | | | | | **P** | | | | S | | | |
| Evergreen scoring | | | | | | | **P** | | | | | | | |
| Content lifecycle | | | | | 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** | | |
| Factual verification | | | | | | | | | | | | | **P** | |
| Primary-source check | | | | | | | | | | | | | **P** | |
| Persona resonance | | | | | | | | | | | | | | **P** |
| Hook-conversion gate | | | | | | | | | | | | | | **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) │
└───────┬───┘ └──────┬───────┘
│ │
└─────┬──────┘
┌────────────────────────────┤
│ │
┌──────▼────────────┐ ┌────────▼───────┐
│analytics- │ │ [PUBLISH] │
│interpreter │ └────────┬───────┘
│(interpret/report) │ │
└───────────────────┘ ┌────────▼───────┐
│engagement-coach│
│(5x5x5 + first │
│ hour + CEA │
│ commenting) │
└────────────────┘
```
### Longform Quality Gates (newsletter)
For longform editions, eight Opus agents run as ordered gates BEFORE lock:
```
draft
─▸ fact-checker (primary-source verification, post-cutoff web search)
─▸ editorial-reviewer (craft: prosa-håndverk + narrativ-arkitektur, Step 5.5)
─▸ persona-reviewer (skeleton → resonance → hook-conversion)
─▸ voice-scrubber (de-AI + Norwegian-chronicle voice)
─▸ headless review (Step 6.5 — COLD on the frozen draft):
content-reviewer (argument integrity C1C5)
language-reviewer (Norwegian language L1L5)
fact-reviewer (cold re-verification F1F4 + pivot-risk)
─▸ LOCK ─▸ delivery
```
### 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 + periodic reports 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?" | analytics-interpreter (report mode) | `/linkedin:report` |
| "Analyze my LinkedIn data" | analytics-interpreter (interpret mode) | `/linkedin:analyze` |
| "What's my LinkedIn strategy?" | strategy-advisor | `/linkedin:strategy` |
| "Help me engage more" | engagement-coach | `/linkedin:strategy` |
| "Who should I comment on?" | engagement-coach | `/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` |
| "Verify facts in this draft" | fact-checker | `/linkedin:newsletter` (longform) |
| "Will this land with my readers?" | persona-reviewer | `/linkedin:newsletter` (longform) |
## Model Selection Rationale
| Model | Agents | Why |
|-------|--------|-----|
| **Opus** | 8 agents (fact-checker, editorial-reviewer, persona-reviewer, voice-scrubber, content-reviewer, language-reviewer, fact-reviewer, post-feedback-monitor) | Longform judgment + 48h post-monitoring: factual verification, craft, resonance, voice, cold adversarial re-review, real-time intervention |
| **Sonnet** | 11 agents | Complex reasoning: optimization, strategy, analysis, scoring, scripting, comment targeting |