Автор на Хабре поделился опытом создания документации для небольших мобильных приложений, разрабатываемых в режиме вайб-кодинга с использованием ИИ-агента Claude Code (на данный момент Opus 5). В статье описаны ключевые документы, которые помогают структурировать процесс разработки и сохранять историю решений.
Вайб-кодинг — это подход, при котором разработчик формулирует задачу на естественном языке, а ИИ-агент генерирует код. В таких проектах документация часто отходит на второй план, но автор предлагает систему, которая позволяет отслеживать прогресс и фиксировать важные решения.
Основой документации являются три документа: концепция приложения, концепция проекта и карта проекта. Концепция приложения — это краткое описание на языке пользователя, отвечающее на вопрос «Чего хочет пользователь?». Она создается до начала разработки и хранится в архиве без изменений. Концепция проекта — более детальное описание, включающее пользовательские истории, бизнес-процессы, технические параметры (язык программирования, фреймворк, структуру данных) и общие параметры (локализация, монетизация). Этот документ также архивируется и используется как ориентир для дорожной карты.
Документация включает концепцию приложения, концепцию проекта и карту проекта, которые хранятся в архиве.
Карта проекта, в отличие от концепций, является рабочим инструментом. Она строится на основе концепции проекта и служит для отслеживания прогресса: что сделано, какие задачи следующие. Карта может обновляться, дополняться новыми задачами, но важно сохранять связь с исходной концепцией, чтобы не потерять направление.
Отдельно автор описывает документы по итогам чатов и сессий. Итоги чата — это оглавление тем, которые обсуждались, составляемое моделью в два прохода: сначала черновой список, затем укрупнение. Решения — это отобранные из тем значимые решения, которые повлияли на разработку. Каждое решение описывается по структуре: проблема, предложенное решение, обоснование. Решения сохраняются в отдельных файлах в папке /decisions внутри контекстной папки /docs, а также ведется файл DECISIONS_INDEX для быстрого поиска.
Такая система документации позволяет не только упорядочить процесс разработки, но и сохранить историю для анализа: сравнивая исходные концепции с конечным результатом, можно понять, что изменилось и почему. Это особенно полезно в вайб-кодинге, где процесс может быть менее предсказуемым, чем при традиционной разработке.
