Pi Planner

Planner workflow extension for Pi with a strict three-phase flow:

1. Planning (questioning + clarifications)
2. Implementation (execute changes)
3. Summary (final recap, no further edits)

Install

pi install npm:pi-planner

Then run:

/reload

Usage

Start planning

/plan Build a desktop-first landlord maintenance app

Planner commands

• /plan [goal] — start planning mode
• /plan execute — force switch to implementation mode
• /plan status — show planner state
• /plan doctor — diagnostics (model/tools/state)
• /plan off — disable planner and restore default tools

What this extension does

• In planning mode, it enforces read-only exploration and asks structured multiple-choice clarifying questions via planner_questionnaire.
• After a plan is finalized (planner_finalize_plan), it auto-switches to implementation mode.
• In implementation mode, it enables coding tools and nudges finder-first execution.
• After implementation, it enters summary mode (read-only) and produces a final recap.

Notes

• This package is a Pi package (not an npx installer).
• Install/update/remove it with Pi package commands:

pi install npm:pi-planner
pi update
pi remove npm:pi-planner

Development

git clone https://github.com/TheDenz3l/Pi-Planner.git
cd Pi-Planner

Test locally without publishing:

pi install /absolute/path/to/Pi-Planner
/reload

License

MIT