Как написать ТЗ для Claude Code: шаблон из 5 блоков

Шаблон из 5 блоков, который превращает идею в документ для Claude Code. AI собирает MVP с первого раза — без бесконечных правок.

Зачем это нужно?

Ты наконец решился. Идея в голове давно, разработчика нет, нанимать дорого — ты ставишь Claude Code, открываешь папку и пишешь:

Сделай мне трекер привычек.

Через пять минут у тебя на экране что-то работает. Только это не твой трекер. В твоём — один экран, крупные кнопки, утреннее уведомление и сразу видно серию дней. А тут — форма добавления с десятью полями, какой-то календарь, статистика за год. Ты начинаешь править: «убери календарь», «сделай одну кнопку вместо формы», «серию дней — наверх». Через час правок — франкенштейн. Что-то отвалилось, что-то дублируется. Проще удалить папку и начать заново.

Знакомо?

Проблема не в Claude Code. Проблема в том, что ты дал ему одно предложение и своё воображение. Claude его не видит. Он собрал свою версию твоей идеи — среднестатистический трекер, который пишут в туториалах. А потом ты бесконечно пытаешься натянуть её на картинку в голове.

Лекарство простое и скучное: спецификация. Документ на одну страницу, где ты описываешь ЧТО должен делать продукт — на обычном человеческом языке, не в коде. Claude Code читает этот документ и собирает именно твою версию. С первого раза.

Бонус, о котором обычно забывают: ту же спецификацию ты можешь передать другому AI, живому разработчику или себе самому через два месяца — и она будет работать. Идея в голове — не работает. Документ — работает.

В этом гайде разбираем: что такое спецификация простыми словами, из чего она состоит, как написать её за час и как отдать Claude Code.

Что такое спецификация (если ты никогда этого слова не видел)

Спецификация (ещё говорят «спека», «ТЗ», «PRD» — Product Requirements Document, то есть «документ с требованиями к продукту») — это короткий текст, где ты объясняешь:

что должен делать продукт,
для кого он,
как им пользуются,
что он помнит.

Ключевое: всё это пишется обычными словами. Не в коде. Не в терминах разработчиков. Как если бы ты описывал бриф для дизайнера или объяснял другу по телефону, что ты хочешь сделать.

Что это НЕ

Это не техническое задание на 40 страниц с экранами, таблицами и диаграммами. На одну страницу, максимум две.
Это не список фич в стиле «авторизация, профиль, настройки, экспорт в PDF, уведомления, интеграция с календарём». Список фич без сценария — это подарочный набор хаоса для Claude.
Это не дизайн. Никаких «сделай как у Apple». Дизайн появляется потом, когда ЧТО работает.
Это не бизнес-план. Никаких расчётов выручки и размера рынка.

Сразу проясним: сайт, веб-приложение, мобильное приложение — в чём разница

Дальше в примерах будут встречаться слова «веб-приложение» и «сайт». Чтобы не путаться:

Сайт — любая страница, которую ты открываешь в браузере (Chrome, Safari, Яндекс.Браузер). Новостная статья — сайт. Блог — сайт. Википедия — сайт.
Веб-приложение (ещё говорят «веб-сервис») — это тоже сайт, но он что-то делает: считает, хранит, показывает твои данные, реагирует на нажатия. Google Документы — веб-приложение. Интернет-банк — веб-приложение. Claude.ai — веб-приложение. Открывается так же, как обычный сайт: по ссылке в браузере.
Мобильное приложение — отдельная программа, которую скачивают из App Store или Google Play и запускают с главного экрана телефона. Telegram, Instagram, банк-клиент.

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

Как это работает на практике

Ты пишешь спецификацию в обычном текстовом файле (например, spec.md — файл с расширением .md, это просто текст, открывается любым блокнотом). Кладёшь его в папку с проектом. Говоришь Claude Code: «прочти spec.md и сделай MVP по нему».

MVP (Minimum Viable Product, минимально жизнеспособный продукт) — это самая простая версия продукта, в которой работает одна главная штука. Ничего лишнего. Пользователь может пройти основной сценарий от начала до конца — и этого достаточно, чтобы понять, нужна ли вообще эта идея.

Claude читает твой документ и собирает именно то, что там описано. Не «среднюю версию», а твою.

Из чего состоит спецификация: 5 блоков

Я тестировал десяток шаблонов — от одностраничных брифов до PRD на 15 разделов. Для фаундера без разработчика работает вот такая сборка из пяти блоков. Коротко, целиком помещается на одну-две страницы, Claude Code переваривает с первого раза.

Блок 1. Одно предложение

Самое важное и самое сложное. В одном предложении: что делает продукт и для кого.

Формула:

[Тип продукта] для [кто пользователь], который [главное действие и результат].

Примеры:

«Веб-приложение для домашних виноделов-любителей, которое помогает вести каталог своих бутылок и быстро находить нужное вино к ужину.»
«Мобильный планер тренировок для человека, который ходит в зал три раза в неделю и хочет видеть прогресс за месяц на одном экране.»
«Трекер полива домашних растений, который напоминает, когда поливать и сколько воды налить.»

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

Проверка: прочитай вслух. Если сам себя спрашиваешь «а зачем это вообще?» — переписывай.

Блок 2. Для кого

Один абзац (3–5 предложений) о том, кто твой пользователь. Не «все» и не «люди от 18 до 45». Один конкретный человек. С его жизнью, контекстом и болью.

Примеры формулировок, которые работают:

Чем занимается человек в жизни.
В какой момент он сталкивается с проблемой, которую решает твой продукт.
Что он делает сейчас вместо твоего продукта (Excel, заметки в телефоне, ничего, память).
Почему ему это не нравится.

Зачем Claude это нужно: он будет принимать десятки мелких решений — какие слова на кнопках, как объяснить ошибку, что показать первым. Зная пользователя, он принимает эти решения в нужную сторону.

Блок 3. Главный сценарий (это самый важный блок)

Сценарий — это пошаговый рассказ о том, что делает пользователь от момента, когда он открыл продукт, до момента, когда получил результат. Шаг за шагом. Как будто ты снимаешь с него кино.

Правила:

Один главный сценарий. Не три, не пять. Один самый важный — тот, ради которого продукт существует.
Шаги пронумерованы.
Пиши ДЕЙСТВИЯ пользователя и что он ВИДИТ в ответ.
Никаких «система обрабатывает данные». Что конкретно происходит на экране?
Дойди до конца. До результата, который пользователь забирает.

Пример плохого сценария:

Пользователь заходит, добавляет вино, смотрит каталог.

Это не сценарий. Это три слова, из которых Claude соберёт что угодно.

Пример хорошего сценария (из спецификации каталога вин):

Марина открывает приложение. Видит список из своих 23 бутылок — крупные карточки с названием, годом и цветом.

Сверху есть строка поиска и кнопка «Добавить бутылку».

Она планирует ужин с пастой и хочет найти что-то красное сухое, которое уже год лежит и пора выпить. Вводит в поиск «красное».

Список сворачивается до 8 бутылок. Марина видит, что у двух из них год покупки — 2024, значит они лежат дольше всего.

Она нажимает на одну из карточек — открывается детальная страница: фото бутылки, сорт, регион, когда куплена, её короткая заметка «привезла из отпуска, сочное».

Марина решает взять именно её. Нажимает кнопку «Выпита сегодня» — бутылка пропадает из каталога и попадает в раздел «История».

Возвращается к списку. Теперь там 22 бутылки. Закрывает приложение.

Видишь разницу? В первой версии Claude придумает, что добавление вина — это форма с 15 полями и обязательной загрузкой фото через камеру. Во второй — он видит, что Марине важен поиск, что бутылка должна пропадать после «выпита», что карточки должны быть крупными. И соберёт именно это.

Если не получается расписать сценарий — это самый важный сигнал. Значит, ты сам не представляешь, как этим пользуются. Садись и представляй. Буквально: закрой глаза, вообрази человека, который достал телефон, открыл приложение. Что он видит? Куда тыкает? Что получает? Опиши всё, даже очевидное.

Блок 4. Данные

Что продукт должен помнить между сессиями? Простой список сущностей (вещей) и их свойств, на человеческом языке.

Формат: [Сущность]: свойство1, свойство2, свойство3.

Пример для каталога вин:

Бутылка: название, сорт винограда, цвет (красное/белое/розовое), сладость (сухое/полусухое/сладкое), год урожая, год покупки, регион/страна, цена, моя заметка, статус (в погребе / выпито).

Событие дегустации: какая бутылка, когда выпита, оценка (1–5), короткий отзыв.

Зачем это нужно: без такого списка Claude придумает структуру данных сам. Обычно — очень общую, «на всякий случай, вдруг пригодится». В итоге у тебя будет форма из 20 полей, половина из которых тебе не нужна. А нужного поля (например, «моя заметка» — важно именно твоей Марине) — не будет.

Не надо расписывать, как это хранится в базе. Никаких «таблица users с foreign key». Просто список свойств простыми словами.

Блок 5. Интерфейс грубым мазком

Один абзац или короткий список: какие экраны есть в продукте и что на них видно. Не дизайн — а перечень экранов и их содержимого.

Пример:

Главный экран: список всех бутылок в виде крупных карточек, сверху — поиск и кнопка «Добавить».

Экран бутылки: вся информация о ней, заметка, две кнопки — «Редактировать» и «Выпита сегодня».

Экран добавления: форма с полями (название, сорт, цвет, сладость, годы, регион, цена, заметка).

Экран истории: список выпитых бутылок с датой и моей оценкой.

Всё. Четыре экрана. Claude сам решит, как это выглядит стилистически — ты уже указал в блоке 2, кто пользователь, он выберет подходящий тон.

Не пиши про цвета, шрифты, анимации. Это придёт потом, когда у тебя будет рабочий прототип, который ты сможешь посмотреть и сказать «тут слишком мелко, тут зелёное раздражает».

Как написать спецификацию за час: пошагово

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

Шаг 1. Сядь без телефона на 30 минут

Серьёзно. Выключи уведомления, убери телефон. Открой Claude Desktop — не Claude Code, а обычный чат в приложении или браузере на claude.ai. Нам сейчас нужен разговор, а не код.

Возьми лист бумаги и ручку. Или пустой текстовый файл. Запиши три вещи в свободной форме:

Что я хочу сделать (1–2 предложения).
Кому это нужно (1 абзац).
Что этот человек сделает в моём продукте (несколько строчек, как получится).

Не старайся писать красиво. Это черновик для себя. Задача — вытряхнуть из головы всё, что там есть.

Шаг 2. Интервью с самим собой через Claude

Открой Claude Desktop. Напиши примерно так:

Я хочу описать идею своего продукта, чтобы потом отдать её Claude Code для сборки MVP. Вот черновик: [вставь свои три абзаца из шага 1]. Задай мне 10 уточняющих вопросов один за другим — по одному вопросу за раз. Твоя задача — помочь мне увидеть дырки в идее: где я сам не знаю, как это работает. Особенно интересуйся главным сценарием пользователя: что именно он делает, что видит на экране, какой результат забирает.

Claude начнёт задавать вопросы. Отвечай подробно. Лучше всего — голосом через диктовку (на Mac — Fn-Fn, на iPhone / Android — иконка микрофона на клавиатуре, или поставь Wispr Flow если хочется качественнее). Голосом ты расскажешь в 3 раза больше, чем напечатаешь.

Не отвечай «не знаю» — если не знаешь, так и скажи: «не знаю, помоги мне понять». Claude предложит варианты, ты выберешь.

Через 10–15 вопросов у вас накопится много материала.

Шаг 3. Попроси Claude оформить черновик спецификации

Когда чувствуешь, что вопросы закончились и всё существенное обсудили — напиши в том же чате:

Отлично, теперь оформи всё, что мы обсудили, в спецификацию продукта по такому шаблону:

Одно предложение: что делает продукт и для кого.

Для кого (1 абзац про пользователя).

Главный сценарий (пронумерованные шаги: что делает пользователь, что видит).

Данные (что продукт помнит — список сущностей и их свойств).

Интерфейс (список экранов и что на каждом видно).

Пиши просто, без маркетинговых слов. Конкретика. Никакого технического жаргона — я не разработчик.

Claude выдаст первый черновик. Это ещё не финал — это болванка.

Шаг 4. Перечитай сам и безжалостно порежь

Это единственный шаг, который ты делаешь глазами и головой, без AI.

Открой черновик. Прочитай вслух. И проведи три проверки:

Проверка 1: могу ли я представить сценарий как кино? Читай шаги сценария и представляй, как пользователь это делает. Если на каком-то шаге ты затупился — «а как он сюда попал? а что будет, если он ошибся?» — значит, сценарий недостаточно подробный. Допиши.

Проверка 2: каждое предложение — про что-то конкретное? Вычёркивай всё вот это: «удобный», «современный», «интуитивный», «быстрый», «эффективный», «оптимизированный». Это слова, которые ничего не значат. Claude не знает, что для тебя «удобный». Заменяй на конкретику: не «удобный поиск», а «по началу названия находит за один символ».

Проверка 3: есть ли лишнее? Если ты где-то описал фичу, которая не участвует в главном сценарии — выкинь её. В отдельный файл later.md, чтобы не потерять. В спецификации должно быть только то, что нужно для одного главного сценария. Всё остальное — второй релиз.

После этих трёх проходов у тебя останется страница, максимум полторы. Это уже рабочий документ.

Шаг 5. Сохрани как spec.md

Создай папку для будущего проекта. В ней сохрани файл с именем spec.md.

Расширение .md — это обычный текстовый файл в формате Markdown (лёгкая разметка, где заголовки обозначаются решётками, а списки — тире). Открывается любым блокнотом. Claude Code с таким файлом работает идеально.

Всё. У тебя есть спецификация. Теперь — в Claude Code.

Пример полной спецификации: каталог домашних вин

Чтобы всё собралось в голове — вот как выглядит готовая спецификация из пяти блоков. Это не макет, это именно то, что можно положить в spec.md и отдать Claude Code.

CellarBook — каталог моих вин

1. Одно предложение. Веб-приложение для домашнего коллекционера вина-любителя, которое помогает держать каталог бутылок в погребе и быстро выбирать, какую открыть под сегодняшний ужин.

2. Для кого. Марина, 38 лет, менеджер в IT. За последние пять лет насобирала домашний погреб из 20–30 бутылок: что-то привозит из отпусков, что-то берёт на распродажах, что-то дарят друзья. Проблема: она никогда не помнит, что у неё есть. В итоге когда приходят гости, она полчаса роется в шкафу, а бутылки, которые надо было выпить год назад, обнаруживает, когда они уже испортились. Сейчас пробовала вести список в «Заметках», но бросила — лень открывать, неудобно обновлять, поиска нет.

3. Главный сценарий: Марина выбирает вино к ужину.

Марина открывает приложение на ноутбуке (или телефоне).

Видит главный экран: сверху — строка поиска и кнопка «Добавить бутылку», ниже — сетка крупных карточек с её бутылками. На каждой карточке: название, год, цвет кружком, маленькая пометка «в погребе N месяцев».

У неё сегодня паста карбонара. Ей нужно что-то белое сухое, которое пора выпить.

Она вводит в поиск слово «белое» — сетка сворачивается до 7 бутылок.

Она видит, что одна бутылка помечена «в погребе 14 месяцев» — это самая старая. Нажимает на карточку.

Открывается экран бутылки: название, сорт, регион, год, цена покупки, её заметка «купила в Италии, сухое, лимон». Снизу — две кнопки: «Редактировать» и «Выпита сегодня».

Марина решает взять её. Нажимает «Выпита сегодня» — появляется маленькое окно: «Оцени от 1 до 5» и поле для короткого отзыва. Она ставит 4 и пишет «отлично под пасту, купить ещё».

Бутылка пропадает из главного списка и попадает в раздел «История».

Марина возвращается на главный экран — там теперь 22 бутылки. Закрывает приложение и идёт на кухню.

Второстепенный сценарий: добавление новой бутылки.

Марина вернулась из отпуска с тремя бутылками. Открывает приложение, нажимает «Добавить бутылку».

Открывается форма: название, цвет (красное/белое/розовое), сладость (сухое/полусухое/сладкое), сорт винограда, регион, год урожая, цена, моя заметка.

Марина заполняет, нажимает «Сохранить». Бутылка появляется в главном списке.

4. Данные (что приложение помнит).

Бутылка: название, цвет, сладость, сорт, регион, год урожая, дата добавления в каталог, цена, заметка, статус (в погребе / выпита).

Событие «выпита»: какая бутылка, дата, оценка 1–5, короткий отзыв.

5. Интерфейс (экраны).

Главный экран: поиск, кнопка «Добавить», сетка карточек с бутылками в погребе.

Экран бутылки: вся информация, кнопки «Редактировать» и «Выпита сегодня».

Экран добавления/редактирования: форма с полями из блока 4.

Экран истории: список выпитых бутылок с датой, оценкой и отзывом.

Что НЕ делаем в первой версии (потом):

Фото бутылок (сейчас — только текст).

Рекомендации «что под что пить».

Списки желаемого.

Шаринг каталога с друзьями.

Сканирование этикетки камерой.

Обрати внимание: ни слова про «современный дизайн», «адаптивную вёрстку», «удобный UX». Только конкретика. Claude из этого соберёт рабочую первую версию без догадок.

Объём — полторы страницы. Всё. Больше не надо.

Как передать спецификацию в Claude Code

Когда файл spec.md готов — настало время сборки.

Создай пустую папку для будущего проекта (например, на рабочем столе папка cellarbook).
Положи в неё файл spec.md.
Открой эту папку во вкладке Code в Claude Desktop — как именно это сделать, разобрано в гайде Начало работы с Claude Code. Если коротко: вкладка Code — это режим Claude, который работает прямо рядом с файлами твоего проекта и умеет их создавать и править.
В Claude Code напиши:

Прочти файл spec.md в этой папке. Это спецификация продукта, который нужно собрать как веб-приложение (сайт, который что-то делает). Перед тем как писать код — расскажи мне своими словами, как ты понял главный сценарий пользователя, и задай мне 3–5 уточняющих вопросов, если что-то неоднозначно. После того как я подтвержу понимание, начинай собирать. Когда соберёшь — сразу запусти сайт и открой его в браузере, чтобы я мог проверить.

Почему именно так: Claude Code сначала должен показать, что он понял из твоего документа. Если его пересказ отличается от твоей картинки в голове — ты ловишь это до того, как он написал тысячу строк кода. После подтверждения — собирает и сам показывает тебе результат в браузере.

Важно: этот сайт откроется только у тебя на компьютере — он доступен только тебе, на этом устройстве. Чтобы им смогли пользоваться другие люди (друзья, клиенты), сайт нужно отдельно «опубликовать» — выложить на сервер в интернете. Это отдельная тема, для неё будет отдельный гайд. Сейчас главное — чтобы всё заработало у тебя.

Готовый помощник: плагин feature-dev

Если хочется не изобретать процесс самому, есть готовое решение — общедоступный плагин feature-dev для Claude Code.

Что он делает: ты запускаешь команду /feature-dev, плагин сам проводит с тобой структурированное интервью (почти как шаги 2–3 выше, только внутри Claude Code), собирает спецификацию и сразу начинает планировать реализацию. Удобно, если не хочется прыгать между Claude Desktop и Claude Code.

Ставится из меню плагинов в Claude Code (/plugins → найти Feature Dev → Enable).

Это необязательно — спецификацию можно написать и в обычном чате, и передать руками через spec.md. Но если планируешь делать несколько проектов подряд — плагин сэкономит время.

Частые проблемы и как их решать

«У меня слишком много функций, я не могу выбрать одну главную»

Это самая частая проблема. Ты смотришь на свою идею и видишь там каталог, профиль, социальную ленту, уведомления, аналитику, интеграции с календарём — всё важное, всё нужно.

Правило MVP: одна главная функция. Та, без которой продукт не имеет смысла. Всё остальное — второй релиз.

Тест: если бы у тебя было только 3 дня разработки, какую одну вещь ты бы оставил? Это она.

Всё остальное сохрани в отдельный файл later.md — чтобы не потерять идеи, но и не тащить их в первую версию. Когда MVP заработает и ты увидишь, что людям он нужен, — вернёшься к later.md и выберешь следующую функцию.

«Сценарий не получается расписать — я зависаю уже на втором шаге»

Это хорошая новость. Лучше зависнуть сейчас на бумаге, чем потом при правках рабочего кода.

Причина: ты сам ещё не знаешь, как этим пользуются. Это нормально. Решение — стать пользователем на 5 минут.

Закрой глаза. Представь конкретного человека. Он достал телефон. Что он видит первым? Тыкает куда? Что появляется? Что он делает дальше? Каждое мельчайшее движение — в сценарий. Даже очевидное. Особенно очевидное.

Если всё равно тупик — расскажи вслух голосом. Продиктуй в Claude Desktop: «я пытаюсь описать, как пользователь делает Х, но застреваю вот здесь. Задавай мне вопросы, пока я не опишу каждый шаг.» Работает.

«Я не описал данные — Claude же сам разберётся»

Разберётся. Только схема будет универсальная, «на всякий случай». Половина полей тебе не нужна, нужное поле отсутствует.

Пример из жизни: ты не указал, что в каталоге вин важна заметка пользователя. Claude добавляет стандартные поля: название, год, цвет. Заметки нет. Ты начинаешь просить добавить — он добавляет как отдельный экран с комментариями. Ты говоришь «нет, прямо в карточке» — переделывает. А можно было в блоке 4 написать одно слово: «заметка» — и получить это сразу.

Пять минут на блок 4 сейчас экономят полчаса правок потом.

«Я хочу сразу про дизайн — меня беспокоит, как это будет выглядеть»

Это нормальная тревога. Ты представляешь себе красивое и хочешь закрепить это сразу.

Проблема: если ты начнёшь с дизайна, Claude соберёт красивое, но нерабочее. Или рабочее, но ты потом не сможешь нормально ничего изменить, потому что каждое изменение логики будет ломать вёрстку.

Правильный порядок: сначала ЧТО работает, потом КАК выглядит. В спецификации — только список экранов и их содержимое (блок 5). Без цветов, шрифтов и анимаций.

Когда продукт заработает и ты сможешь «потрогать» его в браузере — тогда садись и говори Claude Code голосом: «этот заголовок слишком крупный», «кнопка Выпита — сделай зелёной», «сетка на мобильном пусть будет в один столбец». Это намного проще и точнее, чем описывать дизайн словами в спецификации.

«Claude Code всё равно делает не то, что в спеке»

Бывает. Две причины.

Причина 1: спека всё ещё слишком общая. Вернись к сценарию. Проверь, есть ли там конкретные шаги. Если в спеке написано «пользователь находит нужную бутылку», а не «вводит в поиск слово, видит отфильтрованный список, нажимает на карточку» — Claude придумает свой способ поиска. Допиши конкретику.

Причина 2: Claude действительно промахнулся. Останови его. Не копи правки. Скажи: «Ты собрал не то. Перечитай spec.md, блок 3, шаги 4–6. Там написано, что поиск сворачивает список, а не открывает отдельный экран. Перепиши этот кусок.» Коротко, с указанием конкретного блока спеки.

Если промахнулся второй раз — не продолжай править. Останови, удали папку с кодом (спеку оставь!), запусти Claude Code заново с тем же spec.md. Часто чистый старт с хорошей спекой даёт лучший результат, чем 10 правок кривой версии.

Итог

Спецификация — это не бюрократия и не «правильный процесс для взрослых». Это способ один раз подумать головой, чтобы потом Claude Code не переделывал одну и ту же штуку пять раз.

Короткая версия того, что ты только что прочитал:

Без спеки AI делает свою версию твоей идеи. Со спекой — твою.
Формат: 5 блоков (одно предложение → пользователь → сценарий → данные → экраны), одна-две страницы, файл spec.md.
Пишется за час через разговор с Claude Desktop и честную ручную правку.
Главный блок — сценарий. Шаг за шагом. Если не получается — ты сам ещё не знаешь, как это работает. Стань пользователем на 5 минут.
Одна главная функция на MVP. Всё остальное — в файл «потом».
Передаёшь Claude Code командой «прочти spec.md». Сначала пусть пересказом подтвердит, что понял. Потом — собирает.

Теперь у тебя есть документ, который работает лучше, чем твоё воображение в голове. Следующий шаг — настроить файл CLAUDE.md, чтобы Claude запомнил правила твоего проекта и не переспрашивал одно и то же каждую сессию.

Для тех, кто хочет разобраться в технических деталях

Этот блок можно пропустить. Всё, что нужно для работы, ты уже знаешь. Здесь — просто объяснение того, что происходит под капотом, для любознательных.

Что такое MVP на самом деле. Термин придумал Эрик Рис в книге «Lean Startup» в 2011 году. Идея простая: вместо того чтобы год делать идеальный продукт и узнать, что он никому не нужен, собирай самую простую версию, показывай людям, слушай отзывы и улучшай. MVP — это не «урезанная версия», это «первая версия, на которой можно учиться». Всё, что не участвует в главном сценарии, в MVP не нужно.

Что такое спецификация с точки зрения разработчика. В большом программировании этот документ называют PRD (Product Requirements Document). В классическом виде он занимает 20–40 страниц и описывает продукт до мельчайших деталей: экраны, состояния, ошибки, правила доступа, метрики. Для работы с AI такой объём избыточен — наоборот, модель лучше работает с короткими документами (1–2 страницы), потому что может держать всё целиком в голове. Поэтому в этом гайде — «короткая спека», а не классический PRD.

Что такое .md файл. Расширение .md означает Markdown — это текстовый формат с лёгкой разметкой, придуманный Джоном Грубером в 2004 году. Решётки # обозначают заголовки, звёздочки * — жирный шрифт, тире - — маркированный список. Этот формат стал стандартом для технической документации, потому что его понимают и люди (без специального редактора), и программы, и нейросети. Claude Code (и любые другие AI) читают Markdown лучше, чем Word-файлы, потому что там нет «лишнего» форматирования.

Почему Claude Code просит подтвердить понимание перед сборкой. Это приём из software-инженерии под названием «rubber duck debugging» — когда ты объясняешь задачу «резиновой уточке» и сам замечаешь в ней противоречия. Для AI это работает так же: заставляя Claude пересказать твою спеку своими словами, ты запускаешь у него проверку на понимание. Часть ошибок ловится на этом шаге, и ты правишь спецификацию ещё до того, как написана первая строка кода.

Как Claude Code вообще запускает «сайт у тебя на компьютере». Под капотом Claude Code создаёт программу (например, на JavaScript с библиотекой React или Next.js), а потом запускает её локально — то есть на твоём ноутбуке как «маленький сервер для одного человека». Браузер открывает адрес вида http://localhost:3000 — это специальный адрес, который означает «этот компьютер». Поэтому сайт виден только тебе. Чтобы другие люди могли его открыть, нужно скопировать эту программу на настоящий сервер в интернете — это называется «деплой» (от английского deploy — развернуть).

Всё. Для работы с гайдом ничего из этого знать не нужно — Claude Code сам всё это делает. Но если интересно, как это устроено — теперь знаешь.