plan-mode

Guides read-only planning conversations that interleave questions with emerging architectural decisions.

Updated Nov 7, 2024
One-click install
npx skills add https://github.com/jeremysball/dotfiles --skill plan-mode-jeremysball
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-mode
Source: https://github.com/jeremysball/dotfiles/tree/main/.pi/skills-archive/plan-mode
Command: npx skills add https://github.com/jeremysball/dotfiles --skill plan-mode-jeremysball

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents premature implementation by enforcing a read-only planning mode where the AI asks clarifying questions and explores tradeoffs before any code is written, solving the blank page problem and reducing rework from wrong assumptions. ## Core Features & Use Cases - Read-Only Enforcement: Blocks all write, edit, and file-modifying operations while allowing read, search, and git inspection commands. - Interleaved Questioning: Questions and partial plans alternate in dialogue so decisions crystallize through conversation rather than a rigid question-then-plan sequence. - Tradeoff Presentation: Presents multiple options with pros, cons, and best-fit scenarios so users make informed architectural choices. - Use Case: When a user asks to add authentication, the skill guides a back-and-forth covering session strategy, password hashing, and storage before any schema or endpoint is sketched. ## Quick Start Activate plan mode and ask the AI to help you plan a new feature through questions before writing any code.

Frequently Asked Questions about plan-mode

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a feature before writing code with an AI assistant?

Activate plan mode to put the assistant in read-only mode where it asks clarifying questions and shares partial decisions as they emerge. The plan crystallizes through back-and-forth dialogue rather than a single upfront specification.

What is the difference between phased planning and interleaved planning?

Phased planning collects all requirements first, then produces a complete plan. Interleaved planning alternates questions with emerging insights, letting users course-correct early before wrong assumptions compound into a full architecture.

Can plan mode modify files or run write commands?

No. Plan mode strictly blocks write, edit, and any file-modifying bash commands. It only permits read operations like cat, grep, find, git status, and git diff for codebase exploration.

When should I exit plan mode and start implementation?

Exit when the user explicitly requests implementation, signals they have provided all context, or confirms the summarized plan. The conversation should feel complete from the user's perspective, not just after a few questions.

How does plan mode handle requests that require file changes?

It stops and informs the user that the operation requires modifying files, then asks whether to exit plan mode and proceed with implementation or continue planning first.