3.9 KiB

Raw Blame History

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:

Agent reads relevant files from shared/
Agent lists available articles in its input folder
You select what to work on
Agent does its work
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

3.9 KiB Raw Blame History