banatie-content/CLAUDE.md

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:

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