# Banatie Content Repository

## Overview

This is a **content repository** for Banatie blog. Content is created by 8 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
├── shared/                 ← Context for all agents
│   ├── banatie-product.md
│   ├── target-audience.md
│   ├── competitors.md
│   ├── content-framework.md
│   └── ...
├── style-guides/           ← Author definitions
│   ├── AUTHORS.md
│   └── {author}.md
├── research/               ← @spy output
├── desktop-agents/         ← Agent configs (read-only reference)
├── 0-inbox/                ← Ideas
├── 1-planning/             ← Briefs
├── 2-outline/              ← Structures  
├── 3-drafting/             ← Drafts + Revisions
├── 4-human-review/         ← Human editing
├── 5-optimization/         ← SEO + Images
├── 6-ready/                ← Ready to publish
└── 7-published/            ← Archive
```

## 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"
---

# Brief
(from @strategist)

---

# Outline
(from @architect)

---

# Draft
(from @writer)

---

# Critique
(from @editor — removed after PASS)
```

## 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 |
| optimization | 5-optimization/ | SEO + images |
| 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 8 Agents

| # | Agent | Role |
|---|-------|------|
| 0 | @spy | Research |
| 1 | @strategist | Topic planning |
| 2 | @architect | Article structure |
| 3 | @writer | Draft writing |
| 4 | @editor | Quality review |
| 5 | @seo | SEO optimization |
| 6 | @image-gen | Visual assets |
| 7 | @style-guide-creator | Author personas |

## What You Do NOT Do

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

These are done by Claude Desktop agents.