# Map of Content — Claude Code + Remotion Vault

This vault distills Sabrina Ramanov's tutorial on building a fully automated, terminal-driven video production pipeline using Claude Code, Remotion, and the Model Context Protocol.

**Start here:** [[_AGENT_PRIMER]] — the 2,500-word distilled prompt that primes you on thesis, concepts, claims, and frame.

## Reading Order for a New Agent

1. **[[_AGENT_PRIMER]]** — orientation
2. **[[framework-automated-content-pipeline]]** — the 4-step spine of the source
3. **[[concept-claude-code]]** → **[[concept-remotion]]** → **[[concept-mcp]]** → **[[concept-agent-skills]]** — the four conceptual primitives
4. **The three claims** ([[claim-local-execution-efficiency]], [[claim-ai-fact-checking]], [[claim-automated-blooper-removal]]) — with enrichment caveats
5. **[[contrarian-cli-video-editing]]** — the paradigm-shift argument
6. **Action items** — what to actually do

## Folder Map

### `concepts/` — The Vocabulary of the Pipeline
- [[concept-claude-code]] — the CLI orchestrator
- [[concept-remotion]] — React video framework
- [[concept-agent-skills]] — installed AI documentation
- [[concept-mcp]] — Model Context Protocol
- [[concept-safe-zones]] — vertical video formatting
- [[concept-programmatic-video]] — code-driven editing
- [[concept-brand-asset-system]] — scaling on-brand output
- [[contrarian-cli-video-editing]] — *(contrarian insight)*

### `claims/` — Testable Assertions
- [[claim-local-execution-efficiency]] — local > cloud (partially supported)
- [[claim-ai-fact-checking]] — LLM agents can verify content (conceptually supported)
- [[claim-automated-blooper-removal]] — AI cuts silences + bloopers (well-supported for simple cases)

### `frameworks/` — Step-by-Step Models
- [[framework-automated-content-pipeline]] — the 4-step automated content pipeline

### `entities/` — People and Tools
- [[entity-sabrina-ramanov]] — speaker, Blotato founder
- [[entity-product-claude-code]] — Anthropic's CLI
- [[entity-product-remotion]] — React video framework
- [[entity-product-perplexity]] — AI search / fact-check
- [[entity-product-blotato]] — social scheduler
- [[entity-product-whisper]] — OpenAI ASR

### `quotes/` — Verbatim Excerpts
- [[quote-claude-changed-creation]] — opening hook
- [[quote-local-execution]] — local-first argument
- [[quote-implicit-triggering]] — skill UX

### `action-items/` — What to Do
- [[action-install-remotion-skill]] — `npx skills add remotion-dev/skills`
- [[action-prompt-safe-zones]] — prompt phrasing for vertical UI safety
- [[action-setup-brand-assets]] — three-file brand system
- [[action-fact-check-prompt]] — embed QA in your prompt

### `prerequisites/` — What You Need First
- [[prereq-terminal-basics]] — CLI navigation
- [[prereq-node-npm]] — Node.js + npm

### `open-questions/` — Unresolved Tensions
- [[question-complex-video-edits]] — narrative editing limits
- [[question-api-costs-scaling]] — economics at scale

## Cross-Cutting Themes

### Theme 1: Local-First Computing
[[claim-local-execution-efficiency]] · [[quote-local-execution]] · [[concept-claude-code]] · [[entity-product-whisper]] · [[question-api-costs-scaling]]

### Theme 2: Agent Tool Use (Knowledge + Action)
[[concept-agent-skills]] (knowledge) · [[concept-mcp]] (action) · [[entity-product-perplexity]] · [[entity-product-blotato]] · [[action-install-remotion-skill]] · [[action-fact-check-prompt]]

### Theme 3: Generative vs Transformative Video
- Generative: [[concept-remotion]] · [[entity-product-remotion]] · [[concept-safe-zones]] · [[action-prompt-safe-zones]]
- Transformative: [[concept-programmatic-video]] · [[entity-product-whisper]] · [[claim-automated-blooper-removal]]

### Theme 4: The CLI-vs-GUI Paradigm Debate
[[contrarian-cli-video-editing]] · [[question-complex-video-edits]] · [[concept-programmatic-video]]

### Theme 5: Brand-Consistent Automation at Scale
[[concept-brand-asset-system]] · [[action-setup-brand-assets]] · [[entity-sabrina-ramanov]]

## How Concepts Connect

```
                  ┌─────────────────────────┐
                  │  entity-sabrina-ramanov │
                  └────────────┬────────────┘
                               │ presents
                               ▼
              ┌────────────────────────────────────┐
              │ framework-automated-content-pipeline│
              └─┬───────┬───────────┬───────────┬──┘
                │ step1 │ step2     │ step3     │ step4
                ▼       ▼           ▼           ▼
         concept-      concept-    concept-    entity-
         remotion      mcp         programmatic product-
            │          │           video         blotato
            ▼          ▼           │
         concept-   entity-        ▼
         agent-     product-    entity-
         skills     perplexity  product-whisper
            │
            ▼
     concept-claude-code  ←─ kernel orchestrating everything
```

## What's Outside This Vault

Topics adjacent to this source but not deeply covered:
- LLM cost optimization
- Color grading workflows
- Multi-camera shot selection
- Audio mixing and mastering
- Legal/copyright compliance for automated content
- Specific React/Remotion API details (would require reading the official docs)

Refer to these in answers but don't pretend the source covers them in depth.
