Работа начинается с текста, а не сразу с кода: в репозитории заводится каталог sdd/ со спецификациями и описанием архитектуры, там же лежат разборы принятых решений. Рядом — правила проекта и CLAUDE.md, то есть спецификация служит контекстом и для человека, и для инструментов.
Ценность в том, что договорённость живёт в том же MR, что и реализация: изменение поведения и изменение его описания приезжают вместе и ревьюятся вместе. Wiki так не умеет — она устаревает молча.
Trial: подход обкатан на крупных продуктовых репозиториях и мы расширяем его на фронтенд. До adopt остаётся определить минимальный полезный объём — для UI-задач полноценная спецификация часто избыточна, а короткий документ по разделу (состояния экрана, ошибки, контракт API) уместен — и договориться, для каких задач спецификация обязательна, а для каких достаточно описания MR.