π-plans — плагин
Расширение планирования для агента Pi: сначала проверенные планы в Markdown, а изменения кода только после вашего одобрения
- 239 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Расширение управляет записью в файлы и запуском делегированных субагентов
- После одобрения исполнители получают право править проект на выбранной вами модели
- Состояние плана и кэш лежат в .git/pi-plans/ и ~/.cache/pi-plans/
Установка
Ручная установка
pi install npm:pi-plansПопробовать без установки: pi -e npm:pi-plans. Нужен Node.js 22.6+ с флагом --experimental-strip-types.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Расширение управляет записью в файлы и запуском делегированных субагентов
- После одобрения исполнители получают право править проект на выбранной вами модели
- Состояние плана и кэш лежат в .git/pi-plans/ и ~/.cache/pi-plans/
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
π-plans — расширение для кодинг-агента Pi по схеме «спланировать, проверить, выполнить». До одобрения запись закрыта: планирование, вопросы и доработка идут только на чтение, а `edit` и `write` заблокированы вне файлов плана, пока не пройдет передача, которая никогда не завершается автоматически. В комплекте 7 скиллов, 25 слэш-команд, 8 инструментов и 2 шаблона. Вопросы одного раунда собираются в одну форму с несколькими вкладками, у каждого варианта указаны плюс и минус. Рецензенты работают только на чтение и возвращают замечания с оценкой серьезности и до пяти вопросов: `plan-normal` запускает двух рецензентов, `plan-big` и `plan-huge` по три, и для каждого планировщик пишет свое направление проверки. План для нескольких версий продукта ведется в одном каталоге. После одобрения выбирается место выполнения: эта сессия, один делегированный субагент или несколько, на модели и уровне усилий по вашему выбору. Исполнители отчитываются о задачах инструментом `plans_update_task`, а доска показывает волны, состояние и доказательства. Независимый рецензент проверяет проверочные условия `VC-###`. Компакция контекста детерминированная, без модели, а граф кода строится на `tree-sitter`.
Для кого. Разработчикам на агенте Pi, которым нужен управляемый процесс: план на согласование, рецензия, исполнение с отчетом по каждой задаче.
Подходит, если
- Большая задача, и агента надо удержать от правок, пока план не одобрен
- Нужны рецензенты, которые найдут скрытую связность и слабые проверки до начала работы
- План должен выполняться на другой, более дешевой модели, чем рецензия
- Работу делят между несколькими субагентами с отчетом по задачам в реальном времени
- Продукт выпускается версиями, и нужен общий план на 2–10 версий
Не подходит, если
- Работа идет в Claude Code или Codex: расширение написано для Pi
- Задача маленькая и не требует плана: накладные расходы на рецензию окупятся не сразу
- Нужен готовый ответ за один ход: процесс содержит паузы на одобрение
Пример запроса к агенту
Составь план для миграции на новую библиотеку логов, прогони рецензентов и покажи форму вопросов до выполненияОграничения
Нужен агент Pi и Node.js не ниже 22.6 с флагом `--experimental-strip-types`: расширение и проверки работают прямо на TypeScript и не имеют зависимостей на этапе выполнения. Автор публикует результат одного парного прогона Terminal-Bench 2.0 (18 из 36 с расширением против 3 из 36 у обычного Pi) и сам называет его пробным и нестабильным по зернам. До одобрения плана запись заблокирована, поэтому для срочных правок процесс придется прервать. Последний коммит сделан в октябре 2026 года.
Как отключить. Удалите пакет через менеджер пакетов Pi. Состояние в каталоге .git/pi-plans/ и артефакты планов в папке запуска остаются на диске, удалите их вручную.
Частые вопросы
Как поставить?
Командой pi install npm:pi-plans. Для пробы без установки подойдет pi -e npm:pi-plans. Точка входа в пакете index.ts регистрирует инструменты, команды, скиллы и защиту записи.
Что блокируется до одобрения?
Инструменты `edit` и `write` вне файлов плана. Планирование, вопросы и доработка идут только на чтение, пока не пройдена передача, которая не завершается автоматически.
Сколько рецензентов?
Два у `plan-normal` и три у `plan-big` и `plan-huge`. Это рецензенты только на чтение: они возвращают замечания с оценкой серьезности и до пяти вопросов.
Где выполняется план?
Вы выбираете после одобрения: текущая сессия, один делегированный субагент или два-четыре. Модель и уровень усилий задаются тем же выбором, что и у рецензента.
Есть ли результаты измерений?
Да, один парный прогон Terminal-Bench 2.0 на 36 задачах: 18 решено с расширением и 3 у обычного Pi. Автор называет его пробным и публикует числа, нестабильность по зернам и оговорки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныБольше тридцати отдельно ставящихся расширений для кодингового агента Pi: цели, режим плана, LSP, лимиты подписок
planr хранит задачи агентной разработки в Markdown-файлах Git и показывает, что готово, заблокировано и ждет решения
Скилл /improve: сильная модель проверяет репозиторий и пишет самодостаточные планы правок, а исполнение отдаете более дешевой модели
Локальный интерфейс в браузере для разметки планов агента и ревью диффов с отправкой замечаний обратно агенту
Скилл Claude Code ведет сложную задачу по циклу исследования, плана, исполнения и разбора, записывая каждое решение на диск.
Writ превращает правила процесса в проверки при вызове инструментов: Claude Code не пишет код, пока вы не одобрили план и тесты
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| π-plans (эта карточка) | нет | 239 | |
| pi-fabric | нет | 335 | другое расширение для Pi с иной задачей; π-plans специализируется на планах с рецензией и защитой записи |
| pi-codex-goal | нет | 207 | расширение Pi с целями в стиле Codex; π-plans строит план, рецензию и отчет по задачам |
Коротко о README
Описание обещает «спланировать, проверить, выполнить». Затем перечислены принципы (запись закрыта до одобрения, форма вопросов, сходящиеся рецензенты, выполнение на другой модели, отчеты исполнителей), нововведения версии 0.9.0, результаты пробного измерения и подробности установки и безопасности.