blog-draft

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

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

$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. Кожне резюме має включати:

   # Джерело: [Назва/URL]
   
   ## Ключові тези
   - Теза 1
   - Теза 2
   
   ## Релевантні цитати/дані
   - Цитата або статистика 1
   - Цитата або статистика 2
   
   ## Як це стосується теми
   Короткий опис релевантності
   

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

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

1. На основі ідеї та досліджених ресурсів представити:

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

2. Поставити уточнюючі запитання:

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

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

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

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

   # План блог-посту: [Назва]
   
   ## Метаінформація
   - **Цільова аудиторія**: [хто]
   - **Тон**: [стиль]
   - **Цільова довжина**: [кількість слів]
   - **Головний висновок**: [ключове повідомлення]
   
   ## Запропонована структура
   
   ### Зачіпка/Вступ
   - Ідея вступної зачіпки
   - Встановлення контексту
   - Теза
   
   ### Розділ 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. Формат:

   # [Назва блог-посту]
   
   *[Необовʼязково: підзаголовок або слоган]*
   
   [Повний вміст з інлайн-цитатами...]
   
   ---
   
   ## Список джерел
   - [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
• Якщо ресурсів недостатньо, попросіть користувача надати більше або запропонуйте додаткове дослідження
• Адаптуйте тон відповідно до цільової аудиторії (технічна, загальна, бізнес тощо)