# Banatie Content Repository

## Overview

This is a **content repository** for Banatie blog and website. Content is created by 9 Claude Desktop agents. You (Claude Code) manage files and structure.

**Core principle:** One markdown file = one article. Files move between stage folders like kanban cards.

## Your Role: Repository Manager

You do NOT write articles — agents do that.
You manage files, validate structure, check consistency.

## Repository Structure

```
banatie-content/
├── CLAUDE.md                    ← You are here
├── content-framework.md         ← System architecture documentation
├── human-editing-checklist.md   ← Human editing guide
├── batch-processing.md          ← Intensive workflow guide
│
├── project-knowledge/           ← Static context (for Claude Desktop Projects)
│   ├── project-soul.md
│   ├── banatie-product.md
│   ├── target-audience.md
│   ├── competitors.md
│   └── dataforseo-guide.md
│
├── shared/                      ← Dynamic context (for operational updates)
│   └── (empty by default)
│
├── desktop-agents/              ← Agent configs (9 agents)
│   ├── 0-spy/
│   ├── 1-strategist/
│   ├── 2-architect/
│   ├── 3-writer/
│   ├── 4-editor/
│   ├── 5-seo/
│   ├── 6-image-gen/
│   ├── 7-style-guide-creator/
│   └── 8-webmaster/
│
├── style-guides/                ← Author personas
│   ├── AUTHORS.md
│   └── {author}.md
│
├── research/                    ← @spy output
├── pages/                       ← @webmaster output (landing pages)
│
├── 0-inbox/                     ← Ideas
├── 1-planning/                  ← Briefs
├── 2-outline/                   ← Structures  
├── 3-drafting/                  ← Drafts + Revisions
├── 4-human-review/              ← Human editing
├── 5-seo/                       ← SEO optimization
├── 6-ready/                     ← Ready to publish (+ image specs)
└── 7-published/                 ← Archive
```

## Context Architecture

### project-knowledge/

Static context files. Added to Claude Desktop Project Knowledge.
Rarely changes. Contains: product info, audience, competitors.

### shared/

Dynamic context. Agents read via MCP at /init.
Used for: operational updates, experiment results, temporary priorities.
**Priority:** shared/ overrides project-knowledge/

## File Format

Each article is ONE file with frontmatter:

```markdown
---
slug: my-article
title: "Article Title"
author: henry
status: drafting
created: 2024-12-22
updated: 2024-12-23
content_type: tutorial
primary_keyword: "main keyword"
---

# Idea
(raw idea, discovery source)

---

# Brief
(from @strategist)

---

# Outline
(from @architect)

---

# Text
(final text — renamed from Draft after PASS)

---

# SEO Optimization
(from @seo)

---

# Image Specs
(from @image-gen)
```

## Status Values

| Status | Folder | Meaning |
|--------|--------|---------|
| inbox | 0-inbox/ | Raw idea |
| planning | 1-planning/ | Brief in progress |
| outline | 2-outline/ | Structure in progress |
| drafting | 3-drafting/ | Writing |
| revision | 3-drafting/ | Revision after critique |
| review | 4-human-review/ | Human editing |
| seo | 5-seo/ | SEO optimization |
| ready | 6-ready/ | Ready to publish |
| published | 7-published/ | Archived |

## Commands

### /status

Show pipeline overview:
- Count files in each stage
- Flag issues (missing author, wrong status)
- List files needing attention

### /validate {slug}

Check specific article:
- Frontmatter complete?
- Required sections for stage?
- Author style guide exists?

### /move {slug} {stage}

Move article to stage (validate first):
- Check transition is allowed
- Update status in frontmatter
- Move file

## Language

- Files: English
- Communication with user: Russian
- Reports: Russian

## The 9 Agents

| # | Agent | Role | Special Tools |
|---|-------|------|---------------|
| 0 | @spy | Research, competitive intelligence | DataForSEO |
| 1 | @strategist | Topic planning, briefs | DataForSEO |
| 2 | @architect | Article structure | — |
| 3 | @writer | Draft writing | — |
| 4 | @editor | Quality review | — |
| 5 | @seo | SEO optimization | DataForSEO |
| 6 | @image-gen | Visual asset specs | — |
| 7 | @style-guide-creator | Author personas | — |
| 8 | @webmaster | Landing pages, web content | — |

## What You Do NOT Do

❌ Write article content
❌ Create briefs or outlines
❌ Make editorial decisions
❌ Generate images

These are done by Claude Desktop agents.

## Key Documentation

- `content-framework.md` — Full system architecture and design decisions
- `human-editing-checklist.md` — What human does after AI review
- `batch-processing.md` — Workflow for content intensives