Специфікація перед кодом (Spec-First Вайбкодинг)(Специфікація перед кодом (Spec-Driven): чому планування в Markdown рятує від годин дебагу)

1. Огляд концепції та призначення

Головна спокуса новачка у вайбкодингу — це швидкість. Здається, що магія ШІ полягає в тому, щоб закинути одне речення: «Зроби мені систему підписок зі Stripe, кабінетом користувача та базою даних» — і дивитися, як за 30 секунд з'являється купа коду.

Але у 95% випадків така ейфорія закінчується крахом: проект видає 50 червоних помилок компіляції, міграції бази даних конфліктують, а спроби попросити «Полагодь це!» лише погіршують ситуацію, стираючи вже написаний робочий код.

Методологія Spec-First (Специфікація перед кодом) — це золотий стандарт зрілої розробки з ШІ. Вона базується на залізному правилі:

Жодного рядка коду, поки архітектурний план у файлі SPEC.md не буде прочитаний і затверджений людиною!

2. Ментальна модель: Хаотичний кодинг проти Spec-First

┌─────────────────────────────────────────────────────────────┐
│                 ДВА ПІДХОДИ ДО ВАЙБКОДИНГУ                  │
├─────────────────────────────────────────────────────────────┤
│ ❌ Хаотичний підхід (Vibe & Pray):                          │
│    «Напиши всю фічу одразу»                                 │
│    ➔ ШІ нагенерував 500 рядків каші                         │
│    ➔ Нічого не працює ➔ 3 години дебагу та нервів           │
├─────────────────────────────────────────────────────────────┤
│ ✅ Підхід Spec-First (Дисциплінований інжиніринг):          │
│    1. Складаємо `SPEC.md` (Архітектура та кроки)            │
│    2. Людина вичитує план: «Отут поправ логіку»             │
│    3. Тільки після ОК: Агент реалізує Крок 1 ➔ Перевірка    │
│    4. Агент реалізує Крок 2 ➔ Перевірка                     │
│    ➔ Чистий, працюючий проект з першого разу!               │
└─────────────────────────────────────────────────────────────┘

3. Чотири кроки методології на практиці

1. Крок 1: Запит на проектування (Planning Prompt):

   «Не пиши код! Ми плануємо додати систему коментарів під статтями. Склади файл SPEC.md, де опиши: схему таблиці в базі даних, необхідні API-роути, список нових компонентів та 4 покрокові задачі реалізації».

2. Крок 2: Рев'ю людиною: Ви відкриваєте створений SPEC.md, читаєте його і вносите правки: «Давай приберемо можливість анонімних коментарів, тільки після логіну».
3. Крок 3: Покрокове виконання (Execution):

   «План затверджено. Тепер виконай ТІЛЬКИ Задачу 1 зі специфікації (створи схему таблиці та міграцію). Решту не чіпай».

4. Крок 4: Верифікація: Ви перевіряєте, що міграція успішно пройшла, і лише тоді даєте команду перейти до Задачі 2.

4. Чому це робить вас 10x інженером

Spec-First підхід перетворює вас із розгубленого користувача, який благає бота полагодити зламаний сайт, на Технічного Директора (CTO). Ви керуєте стратегією та архітектурою, а штучний інтелект слухняно виконує роль швидкого, але дисциплінованого виконавця.