alekseiul/sprut-agent-kit/writing-plans

Планирование реализации

Превращай идеи и спеки в пошаговые планы с конкретными действиями.

Принцип

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

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

Шапка (обязательно)

# [Название] - План реализации
 
**Цель:** Одно предложение - что получим в итоге
**Срок:** Оценка времени
**Зависимости:** Что нужно до начала (инструменты, доступы, данные)
 
---

Задачи

Каждая задача - один атомарный шаг (2-10 минут):

### Шаг N: [Действие]
 
**Что делаем:** Конкретное описание
**Файлы:** Точные пути (создать/изменить/удалить)
**Команды:** Точные команды если есть
**Проверка:** Как убедиться что шаг выполнен
**Результат:** Что получаем после этого шага

Гранулярность

Масштабируй под задачу:

Техническая задача (скрипт, автоматизация):

• Шаг = одно действие: написать, запустить, проверить, закоммитить
• Точные пути к файлам
• Точные команды
• Ожидаемый вывод

Контентная задача (пост, видео):

• Шаг = один этап: исследование, драфт, правка, публикация
• Ссылки на скилы (copywriter, youtube-seo)
• Референсы и источники

Организационная задача (переезд, документы):

• Шаг = одно действие: позвонить, заполнить, отнести
• Контакты и адреса
• Дедлайны

Правила

• Конкретные пути - не "файл конфига", а ~/.config/agent/config.json
• Конкретные команды - не "запусти тест", а bash scripts/memory-benchmark.sh
• Проверка каждого шага - как понять что сделано правильно
• Нет "потом разберёмся" - каждый шаг завершён и проверен
• YAGNI - только необходимые шаги, без "на всякий случай"
• DRY - если шаг повторяется, вынеси в скрипт

Куда сохранять план

• Технический → memory/plans/YYYY-MM-DD-название.md (шаблон: дата + краткое название)
• Контентный → в daily notes
• Разовый простой → прямо в чат, без файла

После плана

Предложи выбор:

1. Сделать сейчас - пошагово в этой сессии
2. Субагент - sessions_spawn для автономного выполнения
3. Крон - если задача по расписанию
4. Сохранить на потом - записать и вернуться