@codella/pi-prompt-plan

Prompt-template plan command for Pi.

Packages

Package details

prompt

Install @codella/pi-prompt-plan from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@codella/pi-prompt-plan
Package
@codella/pi-prompt-plan
Version
0.2.2
Published
May 26, 2026
Downloads
not available
Author
codella
License
MIT
Types
prompt
Size
4.1 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "prompts": [
    "./prompts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@codella/pi-prompt-plan

Plan prompt template for Pi.

This package adds a /plan prompt command. It does not gate tools or modify Pi runtime behavior; it expands to a planning prompt that asks the agent to inspect first, propose a numbered plan, and wait for approval before editing.

Install

pi install npm:@codella/pi-prompt-plan

Command

/plan [task]

Example:

/plan refactor auth handling and update tests

The expanded prompt tells the agent to:

  1. Summarize the goal.
  2. Inspect relevant files and project guidance.
  3. Propose a short numbered plan.
  4. List expected files to edit and validation commands to run.
  5. End with exactly one final non-heading approval line: 👉 **Proceed?**.

Before approval, the agent should do absolutely nothing with side effects: only read-only inspection is allowed. It must not edit files, run mutating commands, install dependencies, commit, push, write files, update state, or otherwise change the system until approval.

After approval, the agent should execute only the approved plan, ask before expanding scope, run validation, and summarize what changed.

Why prompt-only?

A prompt template keeps plan workflows lightweight and explicit. Use it when you want planning discipline without an extension that blocks tools or manages approval state.

License

MIT