От идеи к спецификации

Большинство первых проектов проваливаются не потому, что ИИ написал плохой код. Они проваливаются потому, что никто не решил, что именно строить, до начала стройки.

«Приложение для трекинга тренировок» звучит как план. Это не план — это направление. Как только ты просишь ИИ это собрать, модели приходится придумать сотню решений, которые ты так и не принял. И каждый раз она придумает их по-разному.

Спецификация — это способ принять эти решения осознанно. Это не корпоративный документ. Для соло-билдера она помещается на одну страницу.

Почему «просто собери» идёт не так

Когда промпт размытый, ИИ заполняет пробелы средними значениями. Средние экраны, средние поля, средние сценарии. Получается что-то, что технически работает, но ощущается как ничей продукт.

Хуже того: каждый следующий промпт уводит в сторону. Ты добавляешь фичу, ИИ заново угадывает то, что ты так и не зафиксировал, и проект медленно превращается в кучуполурешений, которые не стыкуются.

Спека останавливает дрейф. Когда ядро записано, каждый промпт строит поверх одного фундамента, а не пересобирает его заново.

Спека на одну страницу

Тебе не нужна методология. Нужны ответы на пять вопросов.

1. Для кого это — и что они делают сейчас?

Не «для всех». Один человек, делающий одну вещь способом, который его бесит.

Дизайнер-фрилансер, который ведёт счета в заметках и забывает, кто ему должен.

Если можешь назвать человека и его текущий кривой костыль — у тебя есть продукт. Если нет — у тебя есть фича в поисках дома.

2. Какую одну задачу решает продукт?

Одно предложение, которое пользователь сказал бы другу:

«Оно показывает, какие счета просрочены, и даёт пнуть клиента в один тап».

Одна задача. Всё остальное — потом.

3. Что пользователь видит на первом экране?

Опиши первый экран простыми словами. На что он смотрит первым делом и что может сделать первым делом?

Если ты не можешь описать первый экран, ИИ тем более не сможет.

4. Какие данные ты хранишь?

Перечисли вещи, которые приложение запоминает. Для приложения со счетами:

• Счёт: имя клиента, сумма, срок оплаты, оплачен/не оплачен
• Клиент: имя, email

И всё. Этот список потом станет твоей базой данных — самую трудную часть ты уже сделал, просто назвав их.

5. Чего в первой версии точно НЕ будет?

Это самый важный вопрос — и его новички пропускают. Запиши, что ты пока не строишь:

• Нет командных аккаунтов
• Нет приёма платежей
• Нет мобильного приложения — только веб

Урезать скоуп на бумаге бесплатно. Урезать его после того, как ИИ всё собрал, — больно.

Преврати спеку в промпты

Теперь спека пишет промпты за тебя. Вместо «собери приложение для счетов» ты идёшь по шагам:

Мы делаем веб-приложение, где фрилансеры ведут счета.
Модель данных: у Счёта есть client_name, amount, due_date
и булево paid. Начни с создания этой структуры данных
и экрана со списком всех счетов, новые сверху.

Каждый следующий промпт ссылается на ту же спеку, так что ИИ не приходится заново угадывать фундамент.

Спека — это черновик, а не контракт

Ты будешь её менять. Обнаружишь, что первый экран не тот, или что настоящая задача — другая. Это нормально: смысл записи не в том, чтобы быть правым в первый день. Смысл — чтобы твои изменения были осознанными, а не случайными.

Потрать тридцать минут на спеку. Это самые дешёвые полчаса во всём проекте — и разница между «построить продукт» и «напромптить себе бардак».