190 lines
4.8 KiB
Markdown
190 lines
4.8 KiB
Markdown
# 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
|