Blog Post Drafting Workflow

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

$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]»