Обзор
Помогает превращать идеи в полноценно проработанные дизайны и спецификации через естественный совместный диалог.
Начните с понимания текущего контекста проекта, затем задавайте вопросы по одному, чтобы уточнить идею. Когда вы поймёте, что именно нужно построить, представьте дизайн небольшими разделами (200–300 слов), каждый раз уточняя, всё ли выглядит правильно на данном этапе.
Процесс
Понимание идеи:
- Сначала изучите текущее состояние проекта (файлы, документацию, недавние коммиты)
- Задавайте вопросы по одному, чтобы уточнять идею
- По возможности предпочитайте вопросы с вариантами ответов, но открытые вопросы тоже допустимы
- В одном сообщении — только один вопрос; если тему нужно разобрать глубже, разбивайте её на несколько вопросов
- Сфокусируйтесь на понимании: цели, ограничения, критерии успеха
Исследование подходов:
- Предложите 2–3 разных подхода с их плюсами и минусами
- Представляйте варианты в разговорной форме, с вашей рекомендацией и объяснением
- Начинайте с рекомендуемого варианта и объясняйте, почему он предпочтителен
Представление дизайна:
- Как только вы уверены, что понимаете, что именно нужно построить, представьте дизайн
- Разбейте его на разделы по 200–300 слов
- После каждого раздела спрашивайте, всё ли выглядит правильно
- Покройте темы: архитектура, компоненты, поток данных, обработка ошибок и другие, которые считаете нужными
- Будьте готовы вернуться и уточнить детали, если что-то непонятно
После дизайна
Документация:
- Запишите утверждённый дизайн в
docs/plans/YYYY-MM-DD-<topic>-design.md
Ключевые принципы
- Один вопрос за раз — не перегружайте несколькими вопросами сразу
- Предпочтение вариантам ответов — на них проще отвечать, чем на открытые вопросы
- YAGNI безжалостно — убирайте все ненужные фичи из дизайнов
- Исследуйте альтернативы — всегда предлагайте 2–3 подхода перед тем, как выбрать один
- Инкрементальная валидация — представляйте дизайн по частям и проверяйте каждый шаг
- Гибкость — возвращайтесь и уточняйте, если что-то не имеет смысла