Дизайн-документ для фичи в кодовой базе

★ 6.9 · vibe-coding

Дизайн-документ для фичи — это скилл для Claude Code, который проводит пользователя через четырёхфазный цикл создания дизайн-документа, укоренённого в реальной кодовой базе: Explore & Interview → Draft → Resolve open questions → Iterate. Берут, когда нужно оформить RFC или спецификацию перед тем, как браться за код; когда архитектурные решения неочевидны и надо зафиксировать открытые вопросы; когда фича затрагивает несколько модулей и хочется согласованный документ, а не разрозненные заметки. На фазе исследования скилл читает README.md, CLAUDE.md, ARCHITECTURE.md, ищет связанные файлы через Grep и Glob, проверяет crosslink knowledge и существующие черновики в .design/; затем задаёт 3–5 уточняющих вопросов, каждый из которых привязан к конкретному файлу или паттерну из кодовой базы. Черновик записывается в .design/<slug>.md со строгой структурой: Summary, Requirements, Acceptance Criteria, Architecture, Open Questions, Out of Scope. Нерешённые вопросы оформляются как HTML-комментарии OPEN и разбираются интерактивно. После написания запускается валидация по чек-листу и документ публикуется в crosslink knowledge. Аргументы --issue, --gh-issue и --continue позволяют стартовать от задачи или продолжить итерацию существующего черновика. Подойдёт командам, работающим с crosslink; не подходит для проектов без кодовой базы или когда структура .design/ и CLI crosslink недоступны.