Session Overview

Sam asked to edit the content-gap-hunter skill to add AI visibility gap analysis and Notion export. During that work, the conversation evolved into a larger architecture discussion: Sam wants a multi-agent content production pipeline with a conductor deploying specialist sub-agents (researcher, writer, designer, SEO finalizer, QA gate). After evaluating Cowork vs. Claude Code for this workload, Sam chose to migrate the pipeline to Claude Code with Cowork remaining as the cockpit for conversational and ad-hoc work.

This session designed the full architecture and built approximately 70% of the migration package as deliverable files.

Key Decisions Made (Do Not Revisit)

  1. Claude Code for pipeline, Cowork for cockpit. The pipeline (discovery, writing, design, SEO, QA) runs in Claude Code with routines and sub-agents. Cowork remains for conversational tasks, ad copy, legal work, and manual review.
  2. Dedicated repo at ~/Projects/content-pipeline. Private GitHub repo, Nathaniel as collaborator.
  3. Sequential sub-agents, not parallel. Single-threaded pipeline with one canonical state file (pipeline-queue.json) as the baton. No parallel writes.
  4. Email-based approval gates with magic links. Not Slack. Gmail MCP sends approval emails after discovery; a webhook (Cloudflare Worker or self-hosted) flips topic status when Sam clicks approve/reject.
  5. Pipeline never auto-publishes. Final state is publish_ready. Sam ships manually.
  6. AI gap scoring: new 6th factor at 15% weight. Rebalanced from volume (35 to 30) and difficulty inverse (10 to 0, folded into volume). AI gap factor: 1.0 competitor cited, 0.5 greenfield/neither, 0.2 we cited, 0.1 both cited.
  7. Inline Perplexity check, not ai-visibility-auditor. The auditor is built for firm-reputation queries, not per-topic lookups. Content-gap-hunter does its own lightweight Perplexity Sonar check. TODO to merge into auditor when it next gets touched.
  8. content-gap-hunter updated SKILL.md is complete and staged in Cowork outputs. Includes: AI visibility step, Notion export, brand-fit gate with avoid-as-standalone list, citation hierarchy enforcement, 6-factor priority formula, dependency declarations.

Files Built (All in Cowork at /home/claude/content-pipeline/)

Complete and ready to install: