267 lines
7.0 KiB
Markdown
267 lines
7.0 KiB
Markdown
# Banatie Content Repository
|
|
|
|
## Overview
|
|
|
|
This is a **content repository** for Banatie blog and website. Content is created by 10 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
|
|
│ └── research-tools-guide.md
|
|
│
|
|
├── shared/ ← Dynamic context (for operational updates)
|
|
│ └── (empty by default)
|
|
│
|
|
├── desktop-agents/ ← Agent configs (10 agents)
|
|
│ ├── 000-spy/
|
|
│ ├── 001-strategist/
|
|
│ ├── 002-architect/
|
|
│ ├── 003-writer/
|
|
│ ├── 004-editor/
|
|
│ ├── 005-seo/
|
|
│ ├── 006-image-gen/
|
|
│ ├── 007-style-guide-creator/
|
|
│ ├── 008-webmaster/
|
|
│ └── 009-validator/
|
|
│
|
|
├── style-guides/ ← Author personas
|
|
│ ├── AUTHORS.md
|
|
│ └── {author}.md
|
|
│
|
|
├── assets/ ← Static assets
|
|
│ └── avatars/ ← Author avatar images
|
|
│
|
|
├── research/ ← @spy output
|
|
├── pages/ ← @webmaster output (landing pages)
|
|
│
|
|
├── 0-inbox/ ← Ideas
|
|
├── 1-planning/ ← Briefs
|
|
├── 2-outline/ ← Structures + Validation
|
|
├── 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, research tools guide.
|
|
|
|
### 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)
|
|
|
|
---
|
|
|
|
# Validation Request
|
|
(from @architect — claims to verify)
|
|
|
|
---
|
|
|
|
# Validation Results
|
|
(from @validator — verification verdicts)
|
|
|
|
---
|
|
|
|
# Text
|
|
(final text — renamed from Draft after PASS)
|
|
|
|
---
|
|
|
|
# SEO Optimization
|
|
(from @seo)
|
|
|
|
---
|
|
|
|
# Image Specs
|
|
(from @image-gen)
|
|
|
|
---
|
|
|
|
# Review Chat
|
|
(comments from @strategist, @architect, @editor during final review)
|
|
```
|
|
|
|
## Status Values
|
|
|
|
| Status | Folder | Meaning |
|
|
|--------|--------|---------|
|
|
| inbox | 0-inbox/ | Raw idea |
|
|
| planning | 1-planning/ | Brief in progress |
|
|
| outline | 2-outline/ | Structure + validation 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
|
|
|
|
### /check-consistency
|
|
|
|
Validate repository structure and cross-references:
|
|
|
|
**Checks:**
|
|
1. Agent folders (000-spy through 009-validator exist with required files)
|
|
2. Stage folders (0-inbox through 7-published match documentation)
|
|
3. Project knowledge files (all referenced files exist)
|
|
4. Cross-references (paths in system-prompt.md, CLAUDE.md, content-framework.md are valid)
|
|
5. Status values (frontmatter statuses match folder structure)
|
|
|
|
**Output format:**
|
|
```
|
|
Repository Consistency Check
|
|
============================
|
|
|
|
Agent Folders:
|
|
✓ 000-spy (system-prompt.md, agent-guide.md)
|
|
✓ 001-strategist (system-prompt.md, agent-guide.md)
|
|
...
|
|
✓ 009-validator (system-prompt.md, agent-guide.md)
|
|
|
|
Stage Folders:
|
|
✓ 0-inbox/
|
|
✓ 1-planning/
|
|
...
|
|
|
|
Project Knowledge:
|
|
✓ project-soul.md
|
|
✓ banatie-product.md
|
|
✗ Missing: some-file.md (referenced in X)
|
|
|
|
Cross-References:
|
|
✓ All paths valid
|
|
or
|
|
✗ Invalid path in 001-strategist/system-prompt.md: /wrong/path
|
|
|
|
Summary: {N} issues found
|
|
Files to fix: {list}
|
|
```
|
|
|
|
## Language
|
|
|
|
- Files: English
|
|
- Communication with user: Russian
|
|
- Reports: Russian
|
|
|
|
## The 10 Agents
|
|
|
|
| # | Agent | Role | Special Tools |
|
|
|---|-------|------|---------------|
|
|
| 000 | @spy | Research, competitive intelligence | DataForSEO, Brave Search, Perplexity |
|
|
| 001 | @strategist | Topic planning, briefs | DataForSEO, Perplexity |
|
|
| 002 | @architect | Article structure, validation requests | — |
|
|
| 003 | @writer | Draft writing | — |
|
|
| 004 | @editor | Quality review | — |
|
|
| 005 | @seo | SEO optimization | DataForSEO, Brave Search |
|
|
| 006 | @image-gen | Visual asset specs | — |
|
|
| 007 | @style-guide-creator | Author personas | — |
|
|
| 008 | @webmaster | Landing pages, web content | Brave Search, Perplexity |
|
|
| 009 | @validator | Fact verification | Brave Search, Perplexity |
|
|
|
|
## Pipeline Overview
|
|
|
|
```
|
|
@spy → @strategist → @architect → @validator → @writer → @editor → human → @seo → @image-gen → publish
|
|
```
|
|
|
|
**Validation gate:** After @architect, @validator must PASS before @writer starts. This prevents publishing unverified claims.
|
|
|
|
## Review Chat System
|
|
|
|
After human editing, articles go through final review:
|
|
- @strategist, @architect, @editor review with `/review` command
|
|
- Each adds comment to Review Chat section
|
|
- All three must say "APPROVED" before publishing
|
|
|
|
## What You Do NOT Do
|
|
|
|
❌ Write article content
|
|
❌ Create briefs or outlines
|
|
❌ Make editorial decisions
|
|
❌ Generate images
|
|
❌ Verify facts
|
|
|
|
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
|