> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Создание SaaS с кодовым агентом: практический процесс

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

_Опубликовано 2026-09-12._
_Обновлено 2026-11-08._

> **Как создавать SaaS с кодовым агентом?**
> Зависит от того, сколько структуры наследует агент. Кодовый агент движется быстрее всего, когда репозиторий уже определяет аутентификацию, тенантность, биллинг, задачи и тесты: он может расширять работающие стыки вместо того, чтобы изобретать их. Начните с одного наблюдаемого результата, держите изменения маленькими и удобными для ревью и заставляйте агента запускать проверки, доказывающие изменение. Если в вашем репозитории нет фундамента, потратьте первые дни на его создание или начните с проверенного кита. Агент, ускоритель, а не замена границам и верификации.

## Начните с наблюдаемого результата

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

Включите в бриф текущее поведение, желаемое поведение и важные случаи отказа. Назовите существующий модуль, владеющий работой. Просьба добавить редактирование профиля должна указывать на слой аутентификации, а не позволять агенту изобрести второе хранилище пользователей. Держите креденшелы вне промптов и скриншотов, вставленный `apps/web/.env.local` или сессионная кука становится частью записи разговора.

Рабочий бриф читается так: «На экране аккаунта позвольте вошедшему пользователю редактировать отображаемое имя и видеть его после перезагрузки. Модуль аутентификации владеет записью пользователя; таблицу не добавляйте. Пустое имя или запрос, называющий запись другого пользователя, должны отклоняться. Докажите это `pnpm test` и одним ручным сохранением на узкой ширине». Пять предложений, и большая часть догадок исчезла.

- Видимый пользователем результат, сформулированный так, чтобы его можно было проверить в запущенном приложении.
- Файл или модуль, который владеет поведением сегодня, и области, которые должны остаться нетронутыми.
- Хотя бы один случай отказа: неаутентифицированная попытка, невалидный ввод или повторный запрос.
- Проверка, которая это доказывает, тестовая команда, фикстура или явный ручной прогон.


## Пусть репозиторий объясняет себя сам

Задокументируйте, как запускать приложение, какие проверки детерминированы и где обеспечивается владение. В supastack `AGENTS.md` фиксирует границу воркспейса, а `.ai/`, решения на уровне файлов. Эти заметки полезнее всего, когда они объясняют следующему участнику, человеку или агенту, почему реализация существует, а не только какие файлы изменились. [Руководство по настройке агента](https://supastack.dev/ru/docs/web/agent-setup.md) показывает, как кит раскрывает этот материал, а [руководство по локальной установке](https://supastack.dev/ru/docs/web/local-setup.md), тот проход, которому агент реально последует.

Просите агента читать соответствующий код перед редактированием. Узкое изменение обычно требует UI, его серверную границу и тесты вокруг неё. Загружать весь репозиторий менее полезно, чем понять несколько мест, решающих, корректно ли новое поведение: проверку владения, схему и право доступа.

Когда функция затрагивает конфигурацию, называйте файл, а не переписывайте его, «добавьте ключ в `apps/web/.env.local`» оставляет секреты на диске. Та же дисциплина касается панелей провайдеров: описывайте назначение, а не вставляйте креденшел.


## Работайте маленькими, проверяемыми изменениями

Агенты надёжнее всего, когда у изменения один владелец и один проверяемый результат. «Добавить редактирование профиля», проверяемо; «улучшить область аккаунта», приглашение к рефакторингам, о которых никто не просил. Если функция раскладывается на изменение схемы, серверную границу и экран, запускайте их отдельными брифами, каждый из которых оставляет сборку зелёной.

Коммитьте или ставьте контрольную точку перед каждым запуском агента. Чистая базовая линия превращает плохой результат в удалённый diff, а не в археологические раскопки, и даёт ревью стабильную пару «до и после» для сравнения.


## Проверяйте по одному полному изменению

Напишите приёмочную проверку до изменения поведения. Для редактирования профиля покройте валидное обновление и неавторизованную попытку. Постройте минимальную реализацию, удовлетворяющую этим случаям, затем проверьте реальное взаимодействие с реалистичным текстом и узким вьюпортом.

Проверяйте diff так же, как результат. Ищите дублированную бизнес-логику, широкую обработку исключений и новые зависимости, решающие проблему, которую стек уже покрывает. Запускайте проверки проекта и фиксируйте, что они устанавливают. Браузерная фикстура может проверить взаимодействие формы; она не может установить, что продакшен-база или внешний провайдер настроены правильно.

Каждая команда отвечает на свой вопрос. `pnpm test` прогоняет поведение на детерминированных fake- и локальных адаптерах, `pnpm check` покрывает линт, проверку типов и форматирование, а `pnpm build` вскрывает интеграционные ошибки, которые проявляются только при сборке бандла. Вместе они, минимальный уровень для ревью; [чек-лист запуска](https://supastack.dev/ru/blog/saas-launch-checklist.md) покрывает то, что ещё предстоит доказать в реальной среде.

```
pnpm test
pnpm check
pnpm build
```


## Когда агент ошибается

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

Упорный провал обычно означает, что бриф предполагает контекст, которого в репозитории нет. Если агент продолжает изобретать второе место для хранения пользователей, исправление, предложение в `AGENTS.md` о том, где живёт идентичность, а не более твёрдый тон. Обновите документ и повторите задачу, [руководство по агентам](https://supastack.dev/ru/docs/web/agents.md), место, где кит держит этот процесс.


## Создано для ИИ-агентств и агентных воркфлоу (BMAD, Claude Code, Cursor)

Всё больше покупателей supastack используют его для ИИ-агентств по разработке. Планирующие агенты в стиле BMAD (Analyst, PM, Architect, QA) превращают бриф клиента в очерченные истории; Claude Code и Cursor реализуют их в репозитории, где уже решены auth, биллинг, мультитенантность и тесты; `AGENTS.md`, документы `.ai/` и Agent Skills удерживают каждого агента в рамках существующих паттернов.

Передаёте ли вы клиенту веб-MVP за пять минут из репозитория одной платформы или поставляете сборки iOS, Android и десктоп из единого монорепо, одна лицензия позволяет строить неограниченное число коммерческих клиентских проектов: без платы за проект, по месту на каждого разработчика с доступом к репозиторию.

- Репозитории одной платформы для быстрых веб-поставок клиентам; единый монорепо для проектов iOS, Android и Desktop
- AGENTS.md, файловая документация .ai/ и Agent Skills, удерживающие агентов BMAD, Claude Code и Cursor внутри архитектуры
- Детерминированный локальный тест-гейт без учётных данных, который ловит регрессии агентов до того, как их увидит клиент
- Одна лицензия, неограниченные клиентские проекты, покупайте от имени клиента и сохраняйте маржу на каждом контракте


## Частые вопросы о работе с кодовым агентом

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

- Может ли кодовый агент построить целый SaaS самостоятельно?, Видимые части он соберёт быстро, но долговечные, авторизация, жизненный цикл биллинга, изоляция данных, по-прежнему требуют брифа, проверки и ревью. Скорость без этого цикла превращается в переделку.
- Насколько большой должна быть задача для кодового агента?, Достаточно маленькой, чтобы результат можно было проверить в запущенном приложении за минуты: один видимый пользователем результат, один владеющий модуль, одна приёмочная проверка.
- Что никогда не должно попадать в промпт?, Секреты провайдеров, сессионные куки, содержимое `.env.local` и данные клиентов. Называйте файлы и позволяйте инструменту читать их локально вместо копирования значений в лог чата.
- Меняет ли написанный агентом код то, как я провожу ревью?, Ревью смещается от набора кода к чтению: ищите в diff дублированную логику, широкую обработку исключений и зависимости, заново решающие проблему, которую стек уже покрывает.
- Какие тесты важнее всего для результата агента?, Те, что закрепляют владение и поведение при сбоях: неавторизованные запросы, невалидный ввод и повторные отправки, а не только удачный путь из демо.
