# Content Creation Framework

## Overview

This repository uses a multi-agent system for content creation. **7 Claude Desktop agents** handle different aspects of content creation, while **Claude Code** manages the repository.

## The Pipeline

```
Research → Planning → Outline → Draft → Review → Optimization → Ready → Published
   @spy    @strategist  @architect  @writer  @editor   @seo/@image   Human    Human
                                              ↑____↓
                                           revision loop
```

## Stage Folders

| Stage | Folder | Purpose | Agent |
|-------|--------|---------|-------|
| Research | `research/` | Competitive intelligence | @spy |
| Ideas | `0-inbox/` | Raw topic ideas | Anyone |
| Planning | `1-planning/` | Briefs with keywords | @strategist |
| Outline | `2-outline/` | Detailed structure | @architect |
| Drafting | `3-drafting/` | Writing + critique | @writer + @editor |
| Human Review | `4-human-review/` | Your editing | Human |
| Optimization | `5-optimization/` | SEO + images | @seo + @image-gen |
| Ready | `6-ready/` | Ready to publish | Human |
| Published | `7-published/` | Archive | Human |

## Agents

### Content Flow Agents (Claude Desktop Projects)

| Agent | Role | Input | Output |
|-------|------|-------|--------|
| @spy | Research | Web, communities | `research/` |
| @strategist | Topic planning | `0-inbox/`, `research/` | `1-planning/` |
| @architect | Structure | `1-planning/` | `2-outline/` |
| @writer | Drafting | `2-outline/` | `3-drafting/` |
| @editor | Quality review | `3-drafting/` | `3-drafting/` |
| @seo | SEO optimization | `5-optimization/` | `5-optimization/` |
| @image-gen | Visual assets | `5-optimization/` | `assets/` |

### Utility Agents

| Agent | Role |
|-------|------|
| @style-guide-creator | Create author personas |
| Claude Code | Repository management |

## Authors

Content is written in specific author voices:

| Author | Persona | For |
|--------|---------|-----|
| Henry | Technical expert | Tutorials, guides, deep-dives |
| Nina Novak | Creative designer | AI art, design, lifestyle |

Author MUST be selected before creating a brief. See `style-guides/` for voice details.

## Language Protocol

- **Files:** Always English
- **Communication:** Russian with agents
- **Tech terms:** Always English even in Russian

## Quality Gate

Before human review, @editor must score ≥ 7/10 on:
- Technical accuracy (25%)
- Structure & flow (20%)
- Voice consistency (20%)
- Actionability (15%)
- Engagement (10%)
- SEO readiness (10%)

## File Structure per Article

```
{stage}/{slug}/
├── meta.yml          ← Required metadata
├── brief.md          ← From @strategist
├── outline.md        ← From @architect
├── draft-v1.md       ← From @writer
├── critique-v1.md    ← From @editor
├── draft-v2.md       ← Revision
├── final.md          ← Human edited
├── seo-package.md    ← From @seo
└── image-brief.md    ← From @image-gen
```

## Working with Agents

### Starting a session with any agent:

1. Agent reads relevant files from `shared/`
2. Agent lists available articles in its input folder
3. You select what to work on
4. Agent does its work
5. Agent saves to repository via Filesystem MCP

### Communicating with agents:

- Speak Russian
- Agents respond in Russian
- Agents save files in English
- Request "Покажи английскую версию" to see full English content

## Repository Management

Use Claude Code (in terminal) for:
- `/status` — See pipeline status
- `/validate {slug}` — Check article validity
- `/move {slug} {stage}` — Move article between stages
- `/consistency` — Full repo check

## Time Estimates

| Phase | Time |
|-------|------|
| Research | 30 min/week |
| Planning | 15-30 min |
| Outline | 15-30 min |
| Draft | 30-45 min |
| Critique | 15-20 min |
| Human Edit | 30-60 min |
| SEO/Images | 15-20 min |
| **Total** | **2-3 hrs/article** |