START HERE — точка входа строительной сессии

Для Stark’а

Новая сессия — одна команда:

/crewsforge-session

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

Дальше она идёт до PR без остановок и присылает отчёт с готовой командой мержа. Мерж — ваш; мержить можно пачками, следующая сессия не ждёт: она ветвится от ветки предшественника и помечает это в PR.

Для сессии

Ты — строительная сессия CrewsForge. Протокол целиком — в скилле crewsforge-session, вызови его первым делом и следуй ему.

Главное, что нужно понять до чтения протокола: роадмап нарезан по срезам продукта, а не по слоям кода. Единица, закрывшая все критерии, но не давшая ничего вызываемого из фронта, — провалена, даже если тесты зелёные. Исключения названы в карточках явно.

Карта документов

Документ	Что там
`.claude/skills/crewsforge-session/SKILL.md`	протокол сессии — девять фаз от осмотра до PR
`ROADMAP.md`	27 срезов: бизнес-задача, сущности, эндпоинты, критерии приёмки. Источник истины о прогрессе
`SESSION-LOG.md`	что сделала каждая сессия, брифы, решения, отклонения, хендоффы
`OPEN-QUESTIONS.md`	вопросы, ждущие ответа Stark’а или юриста
`../crewsforge-architecture-session-2026-08-21/`	проектные документы — 9 шагов и журнал 31 решения
`../rules/coding-rules.md`	правила написания кода
`../rules/documentation-rules.md`	правила документирования
`../../CLAUDE.md`	обзор репозитория, стек, команды проверок

Когда сессия обращается к Stark’у

Всегда — один раз, на бизнес-брифе перед захватом единицы.

Дополнительно — только если решение попадает хотя бы в один пункт фильтра:

Меняет подтверждённое решение №01–№31 или параметр из журнала решений.
Меняет продуктовую поверхность против того, что было утверждено в брифе.
Вводит денежное правило, которого нет в step-документах.
Добавляет платную внешнюю зависимость или новую юридическую экспозицию.
Противоречит схеме шага 2.

Плюс три ситуации вне фильтра: расхождение реализации со step-документом (документ правится через подтверждение), чужая работа в IN_PROGRESS или грязное дерево на старте, и единица G2 (дроп боевой БД).

Всё остальное сессия решает сама, проверяя выбор субагентом-оппонентом, и записывает в SESSION-LOG.md. Вопрос без ответа, не блокирующий работу, — пункт в OPEN-QUESTIONS.md и обход заглушкой или конфиг-флагом.

Определение готовности единицы

Критерии приёмки из карточки ROADMAP.md доказаны тестами
Сквозной HTTP-e2e по реальной БД зелёный (для всех единиц с фронтовой поверхностью)
Swagger содержит все маршруты из утверждённого брифа; примеры запрос-ответ в PR
npx nx affected -t lint,test,build зелёный, вывод приложен
Ревью пройдено (тир по таблице в скилле), замечания исправлены или отклонены с обоснованием
Проектный step-документ актуален
docs/ обновлена по documentation-rules.md
Конвенции: *-core.module, барели src/index.ts, границы Nx, алиасы @crewsforge-back/...