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.