blog-draft

---
name: blog-draft
description: Створення чернетки блог-посту з ідей та ресурсів. Використовуйте, коли користувачі хочуть написати блог-пост, створити контент з дослідження або підготувати статтю. Проводить через дослідження, мозковий штурм, складання плану та ітеративне написання з контролем версій.
---

## Введення користувача

```text
$ARGUMENTS
```

Ви **ПОВИННІ** врахувати введення користувача перед продовженням. Користувач має надати:
- **Ідея/Тема**: Основна концепція або тематика блог-посту
- **Ресурси**: URL, файли або посилання на дослідження (необовʼязково, але рекомендовано)
- **Цільова аудиторія**: Для кого блог-пост (необовʼязково)
- **Тон/Стиль**: Формальний, невимушений, технічний тощо (необовʼязково)

**ВАЖЛИВО**: Якщо користувач запитує оновлення **існуючого блог-посту**, пропустіть кроки 0-8 і починайте безпосередньо з **Кроку 9**. Спочатку прочитайте існуючий файл(и) чернетки, потім продовжуйте з процесом ітерації.

## Потік виконання

Виконуйте ці кроки послідовно. **Не пропускайте кроки та не продовжуйте без затвердження користувача, де це зазначено.**

### Крок 0: Створення папки проєкту

1. Згенерувати назву папки у форматі: `YYYY-MM-DD-short-topic-name`
   - Використати сьогоднішню дату
   - Створити короткий, URL-дружній slug з теми (малі літери, дефіси, макс. 5 слів)

2. Створити структуру папок:
   ```
   blog-posts/
   └── YYYY-MM-DD-short-topic-name/
       └── resources/
   ```

3. Підтвердити створення папки з користувачем перед продовженням.

### Крок 1: Дослідження та збір ресурсів

1. Створити підпапку `resources/` у каталозі блог-посту

2. Для кожного наданого ресурсу:
   - **URL-адреси**: Отримати та зберегти ключову інформацію до `resources/` як markdown-файли
   - **Файли**: Прочитати та підсумувати в `resources/`
   - **Теми**: Використати веб-пошук для збору актуальної інформації

3. Для кожного ресурсу створити файл резюме в `resources/`:
   - `resources/source-1-[short-name].md`
   - `resources/source-2-[short-name].md`
   - тощо

4. Кожне резюме має включати:
   ```markdown
   # Джерело: [Назва/URL]

   ## Ключові тези
   - Теза 1
   - Теза 2

   ## Релевантні цитати/дані
   - Цитата або статистика 1
   - Цитата або статистика 2

   ## Як це стосується теми
   Короткий опис релевантності
   ```

5. Представити резюме дослідження користувачу.

### Крок 2: Мозковий штурм та уточнення

1. На основі ідеї та досліджених ресурсів представити:
   - **Основні теми**, виявлені з дослідження
   - **Потенційні ракурси** для блог-посту
   - **Ключові тези**, які слід розкрити
   - **Прогалини** в інформації, що потребують уточнення

2. Поставити уточнюючі запитання:
   - Який головний висновок ви хочете донести до читачів?
   - Чи є конкретні тези з дослідження, які хочете виділити?
   - Яка цільова довжина? (коротка: 500-800 слів, середня: 1000-1500, довга: 2000+)
   - Щось хочете виключити?

3. **Чекати відповідей користувача перед продовженням.**

### Крок 3: Запропонувати план

1. Створити структурований план, що включає:

   ```markdown
   # План блог-посту: [Назва]

   ## Метаінформація
   - **Цільова аудиторія**: [хто]
   - **Тон**: [стиль]
   - **Цільова довжина**: [кількість слів]
   - **Головний висновок**: [ключове повідомлення]

   ## Запропонована структура

   ### Зачіпка/Вступ
   - Ідея вступної зачіпки
   - Встановлення контексту
   - Теза

   ### Розділ 1: [Назва]
   - Ключова теза A
   - Ключова теза B
   - Підтверджуючі докази з [джерела]

   ### Розділ 2: [Назва]
   - Ключова теза A
   - Ключова теза B

   [Продовжити для всіх розділів...]

   ### Висновок
   - Резюме ключових тез
   - Заклик до дії або завершальна думка

   ## Джерела для цитування
   - Джерело 1
   - Джерело 2
   ```

2. Представити план користувачу та **запитати затвердження або модифікації**.

### Крок 4: Зберегти затверджений план

1. Після затвердження плану користувачем зберегти його як `OUTLINE.md` у папці блог-посту.

2. Підтвердити збереження плану.

### Крок 5: Закомітити план (якщо в git-репо)

1. Перевірити, чи поточний каталог є git-репозиторієм.

2. Якщо так:
   - Додати нові файли до індексу: папку блог-посту, ресурси та OUTLINE.md
   - Створити коміт з повідомленням: `docs: Add outline for blog post - [topic-name]`
   - Відправити на віддалений сервер

3. Якщо не git-репо, пропустити цей крок та повідомити користувача.

### Крок 6: Написати чернетку

1. На основі затвердженого плану написати повну чернетку блог-посту.

2. Точно дотримуватися структури з OUTLINE.md.

3. Включити:
   - Захопливий вступ із зачіпкою
   - Чіткі заголовки розділів
   - Підтверджуючі докази та приклади з дослідження
   - Плавні переходи між розділами
   - Сильний висновок з головною тезою
   - **Цитування**: Усі порівняння, статистика, дані та фактичні твердження ПОВИННІ цитувати оригінальне джерело

4. Зберегти чернетку як `draft-v0.1.md` у папці блог-посту.

5. Формат:
   ```markdown
   # [Назва блог-посту]

   *[Необовʼязково: підзаголовок або слоган]*

   [Повний вміст з інлайн-цитатами...]

   ---

   ## Список джерел
   - [1] Назва джерела 1 - URL або цитата
   - [2] Назва джерела 2 - URL або цитата
   - [3] Назва джерела 3 - URL або цитата
   ```

6. **Вимоги до цитування**:
   - Кожна точка даних, статистика або порівняння ПОВИННІ мати інлайн-цитату
   - Використовуйте нумеровані посилання [1], [2] тощо, або іменовані цитати [Назва джерела]
   - Звʼязуйте цитати з розділом Список джерел наприкінці
   - Приклад: «Дослідження показують, що 65% розробників віддають перевагу TypeScript [1]»
   - Приклад: «React перевершує Vue за швидкістю рендерингу на 20% [React Benchmarks 2024]»

### Крок 7: Закомітити чернетку (якщо в git-репо)

1. Перевірити, чи в git-репозиторії.

2. Якщо так:
   - Додати файл чернетки до індексу
   - Створити коміт з повідомленням: `docs: Add draft v0.1 for blog post - [topic-name]`
   - Відправити на віддалений сервер

3. Якщо не git-репо, пропустити та повідомити користувача.

### Крок 8: Представити чернетку для перегляду

1. Представити вміст чернетки користувачу.

2. Запитати зворотний звʼязок:
   - Загальне враження?
   - Розділи, що потребують розширення або скорочення?
   - Потрібні корекції тону?
   - Відсутня інформація?
   - Конкретні правки або переписування?

3. **Чекати відповіді користувача.**

### Крок 9: Ітерація або фіналізація

**Якщо користувач запитує зміни:**
1. Зафіксувати всі запитані модифікації
2. Повернутися до Кроку 6 з такими змінами:
   - Збільшити номер версії (v0.2, v0.3 тощо)
   - Врахувати всі зауваження
   - Зберегти як `draft-v[X.Y].md`
   - Повторити Кроки 7-8

**Якщо користувач затверджує:**
1. Підтвердити фінальну версію чернетки
2. За бажанням перейменувати на `final.md`
3. Підсумувати процес створення блог-посту:
   - Загальна кількість створених версій
   - Ключові зміни між версіями
   - Фінальна кількість слів
   - Створені файли

## Відстеження версій

Усі чернетки зберігаються з інкрементальним версіонуванням:
- `draft-v0.1.md` — початкова чернетка
- `draft-v0.2.md` — після першого раунду зауважень
- `draft-v0.3.md` — після другого раунду зауважень
- тощо

Це дозволяє відстежувати еволюцію блог-посту та повертатися до попередніх версій за потреби.

## Структура вихідних файлів

```
blog-posts/
└── YYYY-MM-DD-topic-name/
    ├── resources/
    │   ├── source-1-name.md
    │   ├── source-2-name.md
    │   └── ...
    ├── OUTLINE.md
    ├── draft-v0.1.md
    ├── draft-v0.2.md (якщо ітерації)
    └── draft-v0.3.md (якщо більше ітерацій)
```

## Поради щодо якості

- **Зачіпка**: Починайте з питання, дивовижного факту або знайомого сценарію
- **Потік**: Кожен абзац має зʼєднуватися з наступним
- **Докази**: Підтверджуйте твердження даними з дослідження
- **Цитування**: ЗАВЖДИ цитуйте джерела для:
  - Усіх статистик та даних (напр., «За даними [Джерело], 75%...»)
  - Порівнянь між продуктами, сервісами або підходами (напр., «X працює у 2 рази швидше за Y [Джерело]»)
  - Фактичних тверджень про ринкові тенденції, результати досліджень або бенчмарки
  - Використовуйте інлайн-цитати у форматі: [Назва джерела] або [Автор, Рік]
- **Голос**: Підтримуйте послідовний тон протягом усього тексту
- **Довжина**: Дотримуйтесь цільової кількості слів
- **Читабельність**: Використовуйте короткі абзаци, маркери де доречно
- **CTA**: Завершуйте чітким закликом до дії або питанням, що провокує думки

## Примітки

- Завжди чекайте затвердження користувача у зазначених контрольних точках
- Зберігайте всі версії чернеток для історії
- Використовуйте веб-пошук для актуальної інформації, коли надані URL
- Якщо ресурсів недостатньо, попросіть користувача надати більше або запропонуйте додаткове дослідження
- Адаптуйте тон відповідно до цільової аудиторії (технічна, загальна, бізнес тощо)