writing-content

# Writing Content — Интерактивное написание текстов

## Workflow Routing (SYSTEM PROMPT)

**CRITICAL: This section routes EVERY workflow. Always read the appropriate workflow file.**

### Этап 1: Генерация идеи (v2 - с Research + Scoring 0-5)
**Когда пользователь говорит:**
Examples: "придумай идею", "о чём писать", "start writing", "начать писать", "хочу написать о...", "нужна идея для статьи", "помоги с темой", "что написать"

→ **READ:** `~/.claude/skills/writing-content/workflows/1-generate-idea.md`
→ **PREREQUISITES:**
  - `tools/scoring-system.md` (scoring methodology)
  - `references/scoring-criteria.md` (0-5 criteria with examples)

→ **EXECUTE:**
  1. Интерактивная генерация идеи
  2. **Research & Gap Analysis** (NEW)
     - Perplexity search (fallback к WebSearch)
     - Identify content gap
  3. **Scoring 0-5** (NEW вместо binary)
     - Novelty: 0-5 с reasoning + evidence + improvement
     - Resonance: 0-5 с reasoning + evidence + improvement
     - Overall recommendation (strong proceed | proceed | revise | rethink)
  4. **Markdown Export** (NEW)
     - Создать `writing-session-{timestamp}.md` в current directory
     - Section: "Идея" с research + scoring + improvements
  5. Decision: proceed/revise/rethink based on scores

---

### Этап 2: Написание intro (v2 - 3 варианта + AI-Slop Check)
**Когда пользователь говорит:**
Examples: "напиши первый абзац", "создай intro", "write hook", "напиши вступление", "сделай зацепляющее начало", "начало статьи"

→ **READ:** `~/.claude/skills/writing-content/workflows/2-write-intro.md`
→ **PREREQUISITES:**
  - `references/hooks-database.md` (4 hook types + viral patterns)
  - `tools/scoring-system.md`
  - `tools/anti-ai-detector.md`
  - `references/ai-slop-patterns.md`

→ **EXECUTE:**
  1. Load hooks database
  2. **Generate 3 variants** (NEW вместо 1)
     - Variant 1: Question Hook
     - Variant 2: Narrative Hook
     - Variant 3: Argument Hook
  3. **Self-Score каждый вариант** (NEW)
     - Hook Strength: 0-5
     - Clarity: 0-5
     - AI-Slop Score: 0-5 (detection + fixes)
     - Overall: average
  4. **AI-Slop Fixes** (NEW)
     - Threshold: >= 4/5 mandatory
     - Apply fixes if needed, re-score
  5. Present all 3 variants with scores + recommendation
  6. **Markdown Export** (NEW)
     - Append section: "Intro" (all 3 variants + selected)

---

### Этап 3: Тестирование через AI-персоны
**Когда пользователь говорит:**
Examples: "протестируй intro", "test intro", "проверь идею", "оцени intro", "как зайдёт этот текст", "протестируй на аудитории", "проверь как зацепит"

→ **READ:** `~/.claude/skills/writing-content/workflows/3-test-with-personas.md`
→ **EXECUTE:** Создание 3 AI-персон (core/skeptical/novice) и симуляция чтения intro

---

### Этап 4: Полная статья (v2 - с AI-Slop Check)
**Когда пользователь говорит:**
Examples: "напиши полную статью", "expand to article", "write full post", "сделай большой текст", "разверни в статью", "пиши полностью"

→ **READ:** `~/.claude/skills/writing-content/workflows/4-write-full-article.md`
→ **PREREQUISITES:**
  - `tools/anti-ai-detector.md`
  - `references/ai-slop-patterns.md`

→ **EXECUTE:**
  1. Create outline (supporting/resulting points)
  2. Draft section by section
  3. **AI-Slop Check** (NEW)
     - Run detection on draft
     - Apply fixes if score < 4
  4. **Markdown Export** (NEW)
     - Append section: "Drafting" (objective + outline + draft + AI check)

---

### Этап 5: Переписывание для ясности (v2 - с AI-Slop Check)
**Когда пользователь говорит:**
Examples: "улучши текст", "rewrite", "сделай понятнее", "переписать", "упрости язык", "сделай короче и яснее"

→ **READ:** `~/.claude/skills/writing-content/workflows/5-rewrite-clarity.md`
→ **PREREQUISITES:**
  - `tools/anti-ai-detector.md`

→ **EXECUTE:**
  1. Clarity pass
  2. Succinctness pass (verbal summary)
  3. Intrigue pass (dopamine hits)
  4. **AI-Slop Check After Rewrite** (NEW)
     - CRITICAL: Check if rewrite made text MORE AI-like
     - Compare original vs rewritten scores
     - Revert problematic changes if needed
  5. **Markdown Export** (NEW)
     - Append section: "Rewriting" (stats + rewritten text + AI check)

---

### Этап 6: Стиль и полировка (v2 - усиленный AI-Slop Detection)
**Когда пользователь говорит:**
Examples: "добавь стиль", "polish", "финальная версия", "сделай красиво", "добавь личности", "улучши voice"

→ **READ:** `~/.claude/skills/writing-content/workflows/6-style-polish.md`
→ **PREREQUISITES:**
  - `tools/anti-ai-detector.md`
  - `references/ai-slop-patterns.md`

→ **EXECUTE:**
  1. **AI-Slop Detection** (10 red flags - УСИЛЕННАЯ ПРОВЕРКА)
     - Contrast framing, Rule of three, Cringe transitions
     - Present-ing verbs, Vague opinions, Formal language
     - Emoji explosion, Extra em dashes, Symbolic language, Fake personas
     - **Threshold: >= 4/5 MANDATORY**
  2. Voice check (authentic, conversational)
  3. Vividness (живые детали, метафоры)
  4. Poetry (optional, second-order descriptions)
  5. **Markdown Export** (NEW)
     - Append final section: "Polishing" (AI-Slop fixes + style improvements + final text)
     - **sync_status: "complete"**

---

### Этап 7: Генерация визуала (v2 - unchanged from v1, integrated with art skill)
**Когда пользователь говорит:**
Examples: "создай картинку", "нужен визуал", "generate image", "add visual", "сделай иллюстрацию", "нужна картинка к статье"

→ **READ:** `~/.claude/skills/writing-content/workflows/7-generate-visual.md`
→ **EXECUTE:**
  1. Активация art skill для создания визуала
  2. Сохранение в state
  3. (Markdown export если markdown файл уже создан)

---

### Продолжение работы
**Когда пользователь говорит:**
Examples: "продолжить статью", "где мы остановились", "continue writing", "что дальше", "вернуться к статье"

→ **LOAD STATE:** `~/.claude/skills/writing-content/state/current-article.json`
→ **EXECUTE:** Загрузить контекст и продолжить с последнего этапа

---

## Architecture & Design

### Skill Type Classification
**Complex Archetype** — Sophisticated multi-workflow system with external integrations and progressive state management

**Canonical Reference:** `~/.claude/skills/CORE/SKILL-STRUCTURE-AND-ROUTING.md`

### Core Innovation (v2.0)
This skill combines three frameworks:
1. **Julian Shapiro Writing Framework** (Novelty × Resonance = Quality)
2. **AI-Slop Detection System** (10-layer pattern recognition across 4 dimensions)
3. **Progressive Markdown Export** (Dual state: JSON + human-readable markdown)

### Integration Architecture

**State Management Model:**
```
Source of Truth:    state/current-article.json (v2 structure)
                           ↓
                    (synchronization)
                           ↓
Human Interface:    writing-session-{timestamp}.md (progressive append)
```

**State Evolution:**
- **v1 → v2 migration:** Added research, 0-5 scoring, 3 intro variants, markdown export tracking
- **Backward compatibility:** v1 state files still readable (progressive disclosure)
- **Sync mechanism:** Automatic after each workflow step completion

### Workflow Dependency Graph

```
Prerequisites (read first):
├── references/
│   ├── hooks-database.md         → Workflow 2 (intro generation)
│   ├── scoring-criteria.md       → Workflows 1, 2 (0-5 criteria)
│   └── ai-slop-patterns.md       → Workflows 2, 4, 5, 6 (detection)
├── tools/
│   ├── scoring-system.md         → Workflows 1, 2 (methodology)
│   ├── anti-ai-detector.md       → Workflows 2, 4, 5, 6 (algorithm)
│   └── markdown-exporter.md      → Workflows 1, 2, 4, 5, 6 (export)
└── state/
    └── README.md                 → All workflows (state structure)

Workflow execution order:
1-generate-idea (v2) → 2-write-intro (v2) → 3-test-personas →
4-write-article (v2) → 5-rewrite-clarity (v2) → 6-style-polish (v2) →
7-generate-visual
```

### Key v2.0 Additions

**1. Research & Gap Analysis (Workflow 1)**
- **Method:** Perplexity search → WebSearch fallback
- **Purpose:** Identify content gaps before writing
- **Output:** `idea.research` object in state

**2. 0-5 Scoring System (Workflows 1, 2)**
- **Replaces:** Binary yes/no evaluation
- **Parameters:** Novelty, Resonance, Hook Strength, Clarity, AI-Slop Score
- **Structure:** `{ score: 0-5, reasoning: string, evidence: string, improvement: string }`
- **Decision Thresholds:**
  - >= 4 both: Strong Proceed
  - >= 3 both: Proceed
  - < 3 either: Revise/Rethink

**3. 3 Intro Variants with Self-Scoring (Workflow 2)**
- **Variants:** Question Hook, Narrative Hook, Argument Hook
- **Each scored independently:** Hook Strength, Clarity, AI-Slop
- **Selection:** User chooses based on scores + recommendation
- **State:** `intro.variants[]` array with 3 objects

**4. AI-Slop Detection (4 Layers, All Workflows)**
- **Layer 1: Lexical Scan** — Red/Yellow flag words (32 patterns)
- **Layer 2: Structural Scan** — Perfect structure, transition overload, list mania
- **Layer 3: Tonal Scan** — Безликость, formality, fake enthusiasm
- **Layer 4: Sentence Patterns** — Contrast framing, -ing verbs, hedging
- **Threshold:** >= 4/5 mandatory for all workflows
- **Critical Check (Workflow 5):** Ensures rewriting doesn't ADD AI patterns

**5. Progressive Markdown Export (All Workflows)**
- **File:** `writing-session-{YYYY-MM-DD-HHMMSS}.md` in current directory
- **Sections:** Idea → Intro → Testing → Drafting → Rewriting → Polishing
- **Append-only:** Each workflow appends its section
- **Sync tracking:** `article.markdown_export.sections_written[]` array
- **Completion:** `sync_status: "complete"` when workflow 6 finishes

### External Integrations

**Skills:**
- **art skill** — Visual generation (Workflow 7)
- **research skill** (optional) — Enhanced data gathering

**Search Services:**
- **Perplexity** (primary) — Research & gap analysis
- **WebSearch** (fallback) — If Perplexity unavailable

### Capabilities Matrix

| Capability | Workflows | New in v2.0 |
|------------|-----------|-------------|
| Idea Generation | 1 | ✅ Research + 0-5 scoring |
| Hook Creation | 2 | ✅ 3 variants + self-scoring |
| AI-persona Testing | 3 | (unchanged) |
| Full Drafting | 4 | ✅ AI-Slop detection |
| Clarity Rewriting | 5 | ✅ AI-Slop check after rewrite |
| Style Polishing | 6 | ✅ Enhanced 10-pattern detection |
| Visual Generation | 7 | (unchanged) |
| State Persistence | All | ✅ Dual JSON + Markdown |
| Progress Tracking | All | ✅ Markdown export sync |

---

## When to Activate This Skill

### Direct Writing Requests (Categories 1-4)
- "напиши статью", "write article", "создай контент", "write post"
- "помоги написать", "нужна помощь с текстом", "assist with writing"
- "начать писать", "start writing", "создать текст", "compose content"
- "напиши о [тема]", "write about [topic]", "статья про [тема]"

### Idea Generation (Category 5)
- "придумай идею", "generate idea", "о чём писать", "what to write about"
- "нужна тема для статьи", "find topic", "help with topic"
- "что написать", "suggest topic", "мне нужна идея"

### Content Testing (Category 6)
- "протестируй контент", "test content", "проверь текст", "validate idea"
- "как зайдёт текст", "оцени intro", "evaluate hook"
- "проверь на аудитории", "test with audience"

### Content Improvement (Category 7)
- "улучши текст", "improve writing", "rewrite", "переписать"
- "сделай понятнее", "make clearer", "упрости", "simplify"
- "добавь стиль", "add style", "polish", "финальная версия"

### Visual Content (Category 8)
- "создай картинку", "generate visual", "нужна иллюстрация"
- "add image", "create diagram", "сделай визуал"

---

## Core Capabilities

**Что даёт этот skill:**

1. **Генерация идей** — Интерактивная помощь в поиске темы с валидацией по 5 типам novelty (Julian Shapiro)
2. **Написание hooks** — Создание зацепляющих первых абзацев по проверенной структуре
3. **AI-тестирование** — Симуляция реакции 3 типов аудитории за 2 минуты (vs 24+ часов реального теста)
4. **Полная статья** — Структурированное написание с outline, supporting/resulting points
5. **Переписывание** — Улучшение clarity, succinctness, intrigue
6. **Стилизация** — Добавление voice, vividness, authentic tone
7. **Визуальный контент** — Интеграция с art skill для генерации иллюстраций

---

## Core Principles (Julian Shapiro Framework)

### Writing Quality = Novelty × Resonance

**Novelty (Draft 1):**
- **Counter-intuitive** — То, что противоречит общепринятому
- **Counter-narrative** — Против популярного нарратива
- **Shock and awe** — Неожиданные факты/статистика
- **Elegant articulations** — Красиво сформулированные идеи
- **Make someone feel seen** — Описать чувство, которое человек испытывает но не может выразить

**Resonance (Draft 2+):**
- **Stories** — Истории делают идеи запоминающимися
- **Analogies** — Сравнения помогают понять сложное
- **Examples** — Конкретные примеры вместо абстракций
- **Authentic voice** — Пиши как говоришь с другом

### The Process
1. **Choose topic + objective** — Что хочешь донести?
2. **Write intro with hook** — Зацепи с первой строки
3. **Test with AI personas** — Мгновенная валидация на 3 типах аудитории
4. **Write full article** — Outline → draft по структуре
5. **Rewrite** — Clarity + succinctness + intrigue
6. **Polish** — Voice + vividness + poetry
7. **Add visual** (optional) — Иллюстрация через art skill

---

## Workflow Overview

**Последовательные этапы:**

1. **1-generate-idea.md** — Генерация и валидация идеи
   - Интервью с пользователем (аудитория, проблема, инсайт)
   - Валидация по 5 типам novelty
   - Формулировка идеи в 1 предложение

2. **2-write-intro.md** — Написание зацепляющего intro
   - Выбор типа hook (question/narrative/research/argument)
   - Создание 3 вариантов hooks
   - Написание полного intro (3-5 предложений)

3. **3-test-with-personas.md** — Тестирование через AI-персоны
   - Создание 3 архетипов (Core/Skeptical/Novice)
   - Stream of consciousness reading (естественные мысли при чтении)
   - Aggregated score + рекомендации

4. **4-write-full-article.md** — Написание полной статьи
   - Создание outline (supporting/resulting points)
   - Drafting по секциям
   - Conclusion с takeaway

5. **5-rewrite-clarity.md** — Переписывание для ясности
   - Clarity (простой язык для 13-летнего)
   - Succinctness (verbal summary, убрать filler)
   - Intrigue (dopamine hits, withholding info)

6. **6-style-polish.md** — Финальная стилизация
   - Voice (authentic, как говоришь с другом)
   - Vividness (живые детали, метафоры)
   - Poetry (second-order descriptions)

7. **7-generate-visual.md** — Генерация визуала
   - Выбор типа визуала
   - Интеграция с art skill
   - Сохранение результата

---

## State Management

**Все данные сохраняются в:**
`~/.claude/skills/writing-content/state/current-article.json`

**Структура state:**
```json
{
  "id": "uuid",
  "created": "timestamp",
  "updated": "timestamp",
  "status": "idea|intro|testing|drafting|rewriting|polishing|complete",
  "idea": {
    "rawIdea": "string",
    "refinedIdea": "string",
    "audience": "string",
    "problem": "string",
    "noveltyType": "counter-intuitive|counter-narrative|shock-awe|elegant|make-seen"
  },
  "intro": {
    "hook": "string",
    "hookType": "question|narrative|research|argument",
    "fullIntro": "string",
    "version": 1
  },
  "persona_test_results": {
    "personas": [...],
    "aggregate_score": 0-100,
    "recommendation": "proceed|revise|rethink"
  },
  "article": {
    "objective": "string",
    "outline": ["string"],
    "draft": "string",
    "rewritten": "string",
    "final": "string"
  },
  "visual": {
    "requested": true,
    "type": "string",
    "image_url": "string",
    "alt_text": "string"
  }
}
```

**Можно продолжить в любой момент:**
- "продолжить статью"
- "где мы остановились?"
- "continue writing"

---

## Examples

### Example 1: От идеи до тестирования

**User:** "Хочу написать статью про email-маркетинг"

**Claude:** [Загружает workflow 1-generate-idea.md]
```
Отлично! Давай проработаем идею.

1. Для кого эта статья? (твоя целевая аудитория)
2. Какую проблему они пытаются решить?
3. Какой инсайт/неожиданный подход ты можешь дать?
```

**User:** "Для маркетеров B2B SaaS. Они пишут emails но люди не читают."

**Claude:**
```
Хм, интересно. Что если...

💡 Идея: "Большинство маркетеров пишут email неправильно - они думают главное это информация, но на самом деле главное это первая строка."

Это counter-intuitive ✅ (против того что все думают)

Хочешь доработать или двигаемся дальше?
```

**User:** "Давай напишем intro"

**Claude:** [Автоматически переходит к workflow 2-write-intro.md]
```
Отлично! Выбери тип hook:

1. Question: "Почему люди не читают твои email?"
2. Narrative: "Вчера я отправил 100 email. Открыли 5."
3. Research: "Исследование показало: 80% email удаляют не читая."

Какой зацепит твою аудиторию?
```

**User:** "Давай протестируем intro"

**Claude:** [workflow 3-test-with-personas.md]
```
Создаю 3 персоны для теста...

👤 Алексей (Core) - Head of Marketing, 32 года
👤 Мария (Skeptical) - CMO, опыт 10 лет
👤 Дмитрий (Novice) - Junior маркетолог, 1 год

Симулирую чтение intro...

[Stream of consciousness от каждой персоны]

📊 РЕЗУЛЬТАТ: 78% (ХОРОШО)
✅ Можно переходить к полной статье
```

---

### Example 2: Возврат к незавершённой статье

**User:** "Продолжить статью"

**Claude:** [Загружает state/current-article.json]
```
Нашёл твою статью:

📄 "Email-маркетинг: первая строка решает всё"
📊 Статус: testing (AI-персоны дали 78%)
🎯 Рекомендация: Переходим к написанию полной статьи

Хочешь продолжить?
```

---

### Example 3: Только улучшение текста

**User:** "Переписать текст понятнее" [+ текст]

**Claude:** [workflow 5-rewrite-clarity.md]
```
Анализирую текст...

❌ Проблемы:
- Сложный язык (13-летний не поймёт)
- Много filler words ("в принципе", "так сказать")
- Abstract phrases без примеров

Переписываю...

[Показывает до/после для каждой секции]
```

---

## Extended Context

### Related Skills Integration

**Интеграция с другими skills:**
- **art skill** — Генерация визуалов для статьи (workflow 7)
- **research skill** (если доступен) — Поиск данных/статистики для novelty
- **blogging skill** (если доступен) — Публикация готовой статьи

### Julian Shapiro Resources

Этот skill основан на материалах:
- `Julian Shapiro/1. Writing Handbook - What to Write About`
- `Julian Shapiro/2. Writing First Drafts`
- `Julian Shapiro/3. Rewriting and Editing`
- `Julian Shapiro/4. Writing Style`
- `Julian Shapiro/5. Practicing Writing`

Полный путь: `~/Documents/obsidian-vault/3. projects/Active/Vibemarketing/content-creation/Julian Shapiro/`

### Testing Framework

Оригинальный pipeline тестирования (для справки):
`~/Documents/obsidian-vault/3. projects/Active/Vibemarketing/content-creation/TESTING_CONTENT_IDEAS.md`

Этот skill использует **AI-персоны вместо реального тестирования** для скорости (2 мин vs 24+ часов).

---

## Key Principles

### 1. Интерактивность превыше всего
- Всегда задавай вопросы
- Не делай за пользователя — помогай
- Дай выбор на критичных моментах

### 2. State = память скилла
- Сохраняй после каждого workflow
- Можно вернуться в любой момент
- История изменений (versions)

### 3. Следуй Julian Shapiro строго
- Не изобретай свои методы
- Используй термины из материалов
- Novelty × Resonance — основа качества

### 4. AI-персоны звучат естественно
- Stream of consciousness (думают вслух)
- Filler words ("хм", "ок", "блин")
- Эмоциональные реакции
- Личные связи ("я так делаю")

---

**Related Documentation:**
- `~/.claude/skills/CORE/SKILL-STRUCTURE-AND-ROUTING.md` — Canonical structure guide
- `~/Documents/obsidian-vault/3. projects/Active/Vibemarketing/content-creation/` — Vibemarketing content resources

**Last Updated:** 2025-11-25