Skip to content

PLANS.md

Этот файл задаёт, как exec plans создаются, обновляются, завершаются и архивируются.

Когда план обязателен

Создавайте exec plan, когда работа:

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

Где живут планы

  • docs/exec-plans/active/: планы, которые сейчас ведут работу
  • docs/exec-plans/completed/: завершённые планы, сохранённые для будущего контекста агентов
  • docs/exec-plans/tech-debt-tracker.md: отложенная работа и follow-ups

Минимальные секции плана

  • цель
  • скоуп и out-of-scope
  • путь верификации
  • риски и блокеры
  • лог прогресса
  • открытые решения

Правила работы

  • У одного активного плана должен быть один чётко принадлежащий текущий шаг.
  • Обновляйте план по мере работы; не относитесь к нему как к статической прозе.
  • Если решение меняет направление реализации, зафиксируйте это в плане.
  • Перемещайте завершённые планы в completed/, чтобы агенты могли всё ещё находить прежний контекст.