banatie-content/CLAUDE.md

3.2 KiB

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:

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