Как читать книгу
Что такое паттерн
Паттерн описывает повторяющуюся задачу и способ её решения. Он объясняет принцип, который вы адаптируете под ограничения своего проекта.
Структура главы
Книга содержит паттерны, антипаттерны и обзоры инструментов. Главы о паттернах используют общий шаблон.
- Назначение объясняет, какую задачу решает паттерн.
- Проблема описывает ситуацию и ограничения.
- Решение раскрывает принцип работы.
- Структура показывает участников и связи между ними на диаграмме.
- Когда применять и Последствия помогают оценить условия и компромиссы.
- Реализация и Пример показывают, как применить принцип.
- Антипаттерны, Известные применения и Связанные паттерны дополняют описание ошибками, практикой и соседними подходами.
Антипаттерны объясняют последствия соблазнительного ошибочного действия и предлагают замену. Обзоры OpenSpec, Superpowers и скиллов Мэтта Покока помогают освоить рабочий процесс инструмента и понять условия его выбора. Рядом с командами указана дата проверки, поскольку они зависят от версии.
Группы
Оглавление группирует паттерны по областям работы с агентом. Антипаттерны собраны в отдельном разделе. В репозитории главы лежат в одном каталоге каждого языка, поэтому их удобно читать и на GitHub.
Как выбрать паттерн
Выберите в таблице ситуацию, которая ближе к вашей задаче.
| Ситуация | С чего начать | Что получится | Основная цена |
|---|---|---|---|
| Небольшая, но неочевидная правка | Четыре фазы | Согласованный подход до изменения кода | Отдельное ревью плана |
| Замысел ещё живёт только в голове | Интервью у агента | Самодостаточная постановка задачи | Нужно отвечать на вопросы |
| Готовый план кажется слишком гладким | Гриллинг | Найденные дыры и явные решения | Разговор может открыть новый объём работы |
| Фича переживёт одну сессию | Спеко-ориентированная разработка | Спецификация, план и проверяемые задачи | Артефакты нужно поддерживать |
| Нужна доказуемая корректность | Петля обратной связи | Проверяемый цикл до результата | Качество ограничено качеством оракула |
| Работа слишком велика или расползается | Одна фича за раз и трассирующие тикеты | Маленькие законченные срезы | Больше точек координации |
| Нужно продолжить работу в новом контексте | Журнал прогресса или передача сессии | Восстанавливаемое состояние работы | Документы требуют дисциплины |
| Неясно, выдержит ли идея реальность | Одноразовый прототип | Ответ на конкретный дизайн-вопрос | Прототип придётся выбросить |
Некоторые паттерны решают близкие задачи на разных этапах. Например, журнал прогресса обновляют по ходу работы, а handoff готовят перед сменой сессии. Новая сессия может использовать оба документа, чтобы восстановить состояние и понять ближайший шаг.
Список фич показывает состояние всей работы, а одна фича за раз ограничивает текущий проход. Если способ решения ещё неизвестен, начните с карты исследования, которая помогает закрыть вопросы до составления очереди реализации.