Writing Plans

Writing Plans — это навык, предназначенный для работы с многошаговыми задачами на основе требований или спецификаций до начала написания кода.

Что делает этот навык

Навык используется в ситуациях, когда у вас уже есть описание задачи или требования, и необходимо разложить их на последовательный план действий. Его ключевая цель — заставить агента сначала продумать и задокументировать подход, прежде чем переходить к реализации.

В результате формируется детализированный план внедрения, разбитый на небольшие, понятные шаги, каждый из которых можно выполнить за несколько минут.

Общее описание

Writing Plans — это инструмент архитектурного планирования, который преобразует высокоуровневые требования в конкретные, выполнимые задачи. Он помогает структурировать процесс разработки и поддерживать высокое качество кода за счёт строгого следования принципам вроде DRY, YAGNI и TDD. :

Навык предполагает, что разработчик не знаком с проектом, поэтому каждая задача должна быть описана максимально подробно: с указанием файлов, кода, тестов и команд для выполнения.

Основные сценарии использования

• Декомпозиция сложных функций или фич на небольшие шаги (2–5 минут на задачу)
• Онбординг агентов в незнакомые кодовые базы
• Поддержание дисциплины TDD и частых коммитов
• Создание качественной документации для долгосрочной поддержки проекта

Как работает Writing Plans

• Агент объявляет использование навыка для фиксации контекста планирования
• Создаётся отдельная рабочая ветка (worktree) для изоляции разработки
• Формируется описание цели, архитектуры и используемых технологий
• Задача разбивается на атомарные шаги с точными указаниями
• Каждый шаг включает тест, минимальную реализацию и команды
• План сохраняется в структурированном виде в директории docs/plans/

Структура плана

Каждый план начинается с заголовка и краткого описания:

# [Название фичи] Implementation Plan

Goal: краткое описание цели 
Architecture: общий подход 
Tech Stack: используемые технологии

Далее следует серия задач, каждая из которых включает:

• Список файлов для создания или изменения
• Шаг написания падающего теста
• Запуск теста и проверку ошибки
• Минимальную реализацию
• Повторный запуск тестов
• Команду коммита

Ключевые принципы

• Точные пути к файлам и полный код
• Минимальные изменения для прохождения тестов
• Чёткие команды с ожидаемым результатом
• Частые атомарные коммиты
• Строгое следование TDD

Преимущества подхода

Такой метод снижает вероятность ошибок, делает процесс разработки прозрачным и создаёт удобный журнал изменений. Кроме того, он облегчает передачу задач между агентами или разработчиками, так как каждый шаг уже заранее определён и задокументирован. :

Итог

Writing Plans — это не просто инструмент планирования, а дисциплинированный подход к разработке, который заставляет думать перед тем, как писать код. Он особенно полезен в сложных проектах, где важны предсказуемость, структура и качество реализации.