130 lines
3.9 KiB
Markdown
130 lines
3.9 KiB
Markdown
# 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** |
|