Skill · Plan and specify
/planr:plan$plan@planr-plan
Break a specification or a clear request into user stories and tasks, each task with its files, its dependencies, and the checks that prove it is done. Plan stops at the handoff and never starts building.
/planr:planin Claude Code
$planin Codex. With the OpenPlanr plugin for Codex, use $planr:plan.
@planr-planin Cursor. Cursor applies the planr-plan rule when you mention it in chat.
What it does
Turn a Protocol-compatible specification or product intent into schema-compatible OpenPlanr stories and implementation tasks. Use for planning and decomposition, not implementation.
Plan reads the spec, the repository instructions, the relevant code and tests, and any approved design, then writes stories and tasks next to the spec. Every story gets acceptance criteria with stable IDs, and every criterion maps to a task that names it again in its test requirements. A story never gets more than 2 tasks: one Tech task, or one UI task and one Tech task when it has a design surface.
It validates the frontmatter and the acceptance coverage, then hands you the next ready task and the exact command to build it. See Plan a feature.
When to use it
Use it to
- Decompose a specification into user stories and implementation tasks
- Create an implementation plan from product intent
Not for
- Implement the plan
- Review an already written plan
Example
/planr:plan SPEC-001$plan SPEC-001@planr-plan SPEC-001What you get
.planr/specs/SPEC-001-<slug>/tasks/T-001-<slug>.md---id: "T-001"storyId: "US-001"specId: "SPEC-001"schemaVersion: "1.7.0"type: "Tech"rationale: "<why this task exists>"dependsOn: []preserve: []reviewRisks: []browserSurfaces: []acceptanceRefs: ["AC-001"]---## Objective## Files### Create### Modify### Preserve (do not touch)## Technical Spec## Test Requirements## Definition of DonePrompts and commands
Break a spec into stories and tasks
Get user stories and tasks with acceptance criteria and file-level changes.
Plan straight from a clear request
When the request is already clear, skip the spec and get stories and tasks from it.
Plan UI work from a finished design
Turn a design and its design spec into UI tasks that carry the screens, states, and frames.