Спека продукта
Роли, возможности, экраны и критерии приёмки — живой документ, который агент читает и дополняет
Работает с вашим стеком и агентами
- Claude Code
- Codex
- Cursor
- MCP
- PostgreSQL
- Supabase
- MySQL
- Prisma
- Drizzle
- OpenAPI 3.1
- Gherkin
- Playwright
- Docker Compose
- Zod
- TypeScript
- Mermaid
- DBML
- AGENTS.md
От разговора до готового плана
Агент работает в Studio так же, как вы: через спеку, схему и архитектуру — и ничего не забывает
- 01
Разговор
Вы описываете идею агенту — он создаёт проект в Studio и пишет спеку
Хочу онлайн-запись в барбершоп: клиент выбирает мастера и время, а мастер видит своё расписаниеАгентСоздал проект «Барбершоп» и написал спеку: роли, запись, отзывы. Теперь схема базы. projects_create spec_write db_write - 02
Спека
Роли, экраны, данные и критерии приёмки — Studio сверяет спеку со схемой
# Барбершоп «Усы»
Онлайн-запись к мастеру и отзывы после визита
## Возможности
### Онлайн-запись
- Клиент видит свободные слоты на 14 дней
- Запись подтверждается в Telegram
- Мастер видит своё расписание
- Отмена не позже чем за 2 часа
Критерии приёмки4 / 4 - 03
Схема и данные
Таблицы, линтер, миграции и настоящий Postgres прямо в браузере
clientsiduuidnametextphonevarcharmastersidintnametextdb_lint · 0appointmentsidbigintclient_iduuidmaster_idintstarts_attimestamptz - 04
Архитектура и сборка
Симуляция нагрузки до запуска, план сборки и AGENTS.md в репозиторий
clientload balancerapi ×3postgresp9584 msОшибки0 %Нагрузка1 200 rps
От разговора до готового плана
Агент работает в Studio так же, как вы: через спеку, схему и архитектуру — и ничего не забывает
coddle.uz/studio · Барбершоп «Усы»
Хочу онлайн-запись в барбершоп: клиент выбирает мастера и время, а мастер видит своё расписание
АгентСоздал проект «Барбершоп» и написал спеку: роли, запись, отзывы. Теперь схема базы. projects_create spec_write db_write
# Барбершоп «Усы»
Онлайн-запись к мастеру и отзывы после визита
## Возможности
### Онлайн-запись
- Клиент видит свободные слоты на 14 дней
- Запись подтверждается в Telegram
- Мастер видит своё расписание
- Отмена не позже чем за 2 часа
Критерии приёмки4 / 4
clients
iduuid
nametext
phonevarchar
masters
idint
nametext
appointments
idbigint
client_iduuid
master_idint
starts_attimestamptz
client
load balancer
api ×3
postgres
p95
84 ms
Ошибки
0 %
Нагрузка
1 200 rps
- инструмент MCP для вашего агента
- 56
- правил проверки схемы с исправлением в один клик
- 14
- формата экспорта: от SQL и Prisma до OpenAPI и Docker Compose
- 22
- встроенных плагинов для спеки, схемы и архитектуры
- 12
Всё, что нужно до первой строки кода
Схемы баз данных
DBML или холст, импорт из SQL и Prisma, линтер с исправлением в одно нажатие
users
orders
Песочница Postgres
Тестовые данные, запросы и проверка миграций на настоящем Postgres — без установки
select count(*) from orders;
→ 1 204 · 3 ms
Архитектура и нагрузка
Соберите систему из блоков и посмотрите, выдержит ли она пик, ещё до запуска
lb
api ×3
cache
db
p95 84 msВерсии и миграции
Каждое изменение — версия, структурный diff и готовая SQL-миграция
v3 → v4migration.sql
+ orders.status order_status
+ create index on orders(user_id)
− orders.state text
Командная работа
Приглашения по ссылке, общий доступ для организации и публичные проекты
AMDS
Плагины
Включите — и документ умеет больше
Тесты из критериев, OpenAPI из таблиц, проверка отказов и Docker Compose из архитектуры. Плагин добавляет вкладку, проверки, экспорт и инструмент для агента.
Только встроенные: чужой код не выполняется
Спека
Тест-кейсы
Тесты из критериев приёмки
Feature: Online booking
Scenario: free slots
Then 14 days aheadСпека
Задачи в трекер
Возможности и план — в задачи
gh issue create \ --title 'Online booking' --label feature
Спека
Глоссарий
Слова, без которых спеку не понять
## Glossary - **Slot** — 30 minutes of a barber - **Visit** — a booking that took place
Спека
Риски
Обо что спотыкаются такие продукты
## Risks - **Double booking** — a unique slot - **Payment fails** — check again
Спека
Метрики
Как понять, что возможность работает
## Metrics - **Booking conversion** — above 30 % - **Retention** — after 7 and 30 days
Спека
AGENTS.md в GitHub
Пул-реквест с контекстом проекта
branch coddle/agents-md-20261014 commit + AGENTS.md PR acme/shop#7
Схема БД
REST API
OpenAPI 3.1 из таблиц
GET /clients
POST /appointments
PATCH /appointments/{id}Схема БД
Персональные данные
Где в схеме данные о людях
clients.phone contact clients.password ⚠ hash masters.passport special
Схема БД
Индексы
Как приложение будет читать таблицы
+ users(email) [unique] + orders(user_id, created_at) − orders(user_id)
Схема БД
Именование
Одно соглашение на всю схему
user → users firstName → first_name active → is_active
Архитектура
Проверка отказов
Что будет, если блок упадёт
lb outage ✕ api ×3 ok ✓ db degraded ~
Архитектура
Docker Compose
Архитектура локально
services:
db: postgres:17-alpine
api: { replicas: 3 }Ваш агент уже умеет работать со Studio
Studio — MCP-сервер: агент читает и правит проекты прямо из чата, только в рамках прав, которые вы выдали
- 61 инструмент: спека, схема, миграции, симуляция, плагины, обсуждения, сообщество и экспорт
- Вход через браузер и права по областям — доступ можно отозвать в любой момент
- AGENTS.md переносит весь проект в репозиторий — агенту не нужно объяснять заново
coddle · MCP — Журнал вызовов
- projects_createbarbershop
- spec_writespec
- db_writeschema
- db_lint5 → 0
- db_migrationv1 → draft
- arch_simulate×4 peak
- spec_exportAGENTS.md
7 вызовов · агент работаетбез ошибок
Посмотрите, как это работает
Агент пишет схему, холст её рисует, Studio проверяет и исправляет
По спеке агент проектирует базу и пишет её прямо в Studio — холст обновляется вживую.
Ваш агентcoddle · MCP
Агент подключён к Coddle по MCP и видит ваши проекты.
Напишите агенту…
coddle.uz/studio/you/barbershop/schema
сохраненоонлайнпустой документ
Проверка · 0Версии · 0
Проверки появятся вместе со схемой.
ХолстПесочница
Холст пуст — схему нарисует агент.
0:00 / 0:16
Ещё в Coddle
Практика программирования для тех, кто учится и учит