# plan

Makes the agent read your docs, task notes and source before planning, ask clarifying questions, and only then propose a solution.

- rule · `type=rule` · Claude Code, Cline, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop) · ★ 1054 repo stars
- Author: Bhartendu-Kumar
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Bhartendu-Kumar/rules_template/tree/HEAD/.cursor/rules/plan.mdc
- Updated: 2025-07-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/rules/plan

## What it does

The rule covers planning and architecture work. Before the agent proposes anything it reads `docs/architecture.md`, `docs/product_requirement_docs.md`, `docs/technical.md`, then `tasks/active_context.md` and `tasks/tasks_plan.md`, and after that the code under `src`.

A fixed cycle follows. The agent keeps asking about unclear requirements, splits the problem into sub-problems, weighs candidate approaches against stated trade-offs, and iterates until one solution holds up. Web lookups go through an MCP server named `perplexity-mcp` with its `search` tool, invoked via `use_mcp_tool`. The resulting plan has to name its assumptions and cover failure cases.

When the work is done, the rule asks for the plan to be written back into the same `docs/` and `tasks/` files. Those exact names matter: point it at a repo with no `docs/` and `tasks/` folders and the agent chases paths that are not there, so create the files first, empty ones will do. Cline users place the same text at `.clinerules/plan.md`.

## Install

### Cursor (native platform)

**Manually: put the files in place**
- File: `.cursor/rules/plan.mdc` — Frontmatter: description, globs, alwaysApply

### Claude Code

**Manually: put the files in place**
- File: `.claude/rules/plan.md` — The paths frontmatter field limits the files: move globs from the source into paths

### Codex

**AGENTS.md**
- Codex reads AGENTS.md: paste the rule text there

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/instructions/plan.instructions.md` — The applyTo field sets which files it applies to: move globs from the source into applyTo

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/rules/plan.md`

### Cline

**Manually: put the files in place**
- File: `.clinerules/plan.md`

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Bhartendu-Kumar/rules_template/tree/HEAD/.cursor/rules/plan.mdc

## When to use it
- get requirements clarified before any code changes
- bring existing architecture notes into a planning session
- split a large task into sub-problems with selection criteria
- keep the plan in `tasks/` next to the active context
- record assumptions and failure cases before implementation

## Example prompts
- Read `docs/architecture.md` and `tasks/tasks_plan.md`, then draft a plan following the `plan` rule.
- Plan the payments module rewrite and write the result into `tasks/active_context.md`.
- Ask me about anything unclear in the requirements, then propose a solution with its trade-offs.

## Similar
- [make-plan](https://affpapa.org/en/nevibecode/skills/make-plan.md) — skill · 7700 installs
- [ce-plan](https://affpapa.org/en/nevibecode/skills/ce-plan.md) — skill · 4000 installs
- [speckit-plan](https://affpapa.org/en/nevibecode/skills/speckit-plan.md) — skill · 2600 installs
- [re0-plan](https://affpapa.org/en/nevibecode/skills/re0-plan.md) — skill · 1400 installs
- [plan-task](https://affpapa.org/en/nevibecode/skills/plan-task.md) — skill · 1300 installs
- [to-plan](https://affpapa.org/en/nevibecode/skills/to-plan.md) — skill · 884 installs

From the same set: [bhartendu-kumar/rules_template](https://affpapa.org/en/nevibecode/by/bhartendu-kumar/rules_template.md) — 11 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
