Создание SaaS-платформы для продакшена объемом более 20 000 строк кода с помощью Claude Code: уроки агентной инженерии в масштабе

Обзор проекта

LastSaaS — это готовый к продакшену SaaS-шаблон, каждая строка кода которого написана в ходе диалога с Claude Code. Это не демо или игрушка — он работает на живой платформе под названием Flipbook. Стек включает Go 1.25, React 19, TypeScript, MongoDB и Tailwind, выпущен под лицензией MIT.

Что включает проект

• Полноценный SaaS-фундамент с мультитенантной аутентификацией (OAuth, MFA, волшебные ссылки, ротация JWT)
• Биллинг Stripe (подписки, оплата за пользователя, кредиты)
• Возможности белой маркировки
• 19 типов вебхук-событий
• Админ-панель и мониторинг здоровья
• Встроенный MCP-сервер с 26 инструментами только для чтения, позволяющими AI-ассистентам запрашивать данные дашбордов, пользователей, биллинга и состояния системы

Что сработало

Ясность Go — преимущество для агентов: Отсутствие магии фреймворков означает, что Claude Code не должен догадываться, что делает промежуточное ПО за кулисами. Явная обработка ошибок, понятная маршрутизация и предсказуемые паттерны помогают агенту оставаться на верном пути.

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

MCP-сервер был создан Claude для Claude: 26 инструментов только для чтения создают мета-интерфейс, где ИИ построил собственный способ запроса данных системы.

Документная модель MongoDB упростила мультитенантность: У Claude не возникло проблем с поддержанием изоляции клиентов, потому что модель данных делает границы явными, избегая путаницы с таблицами соединений и утечек абстракций.

Что требовало дисциплины

Вам всё ещё нужна архитектурная концепция: Claude Code — блестящий исполнитель, но не проектировщик систем. Человек должен предоставить архитектуру — понимать, как должна выглядеть мультитенантная RBAC, как должны работать повторные попытки доставки вебхуков и каким должен быть процесс интеграции со Stripe.

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

Боритесь с дрейфом паттернов: В ходе длинных сессий Claude может незаметно отклоняться от установленных паттернов. Периодическое возвращение к основам помогает: «Посмотри, как мы реализовали обработчик пользователя. Следуй тому же паттерну для вебхуков».

Концепция «Создано для агентов»

Кодовая база намеренно структурирована так, чтобы когда кто-то форкает её и направляет на неё собственного AI-агента, агент мог бегло её расширять. Это включает предсказуемую структуру файлов, последовательные именования и явные паттерны — фундамент, спроектированный для расширения через диалог.

Репозиторий доступен по адресу https://github.com/jonradoff/lastsaas.