---

name: plan-builder description: Write implementation plans with appropriate templates based on complexity. Provides minimal, standard, and comprehensive templates for different scope levels. allowed-tools: Read, Write, Edit

Plan Builder

Write implementation plans using the appropriate template based on complexity.

Template Selection

Complexity	When to Use	Template
Minimal	Simple bugs, small improvements, clear single-file changes	resources/minimal.md
Standard	Most features, complex bugs, team collaboration	resources/standard.md
Comprehensive	Major features, architectural changes, multi-phase work	resources/comprehensive.md

Selection Criteria

Use Minimal When

• Fix is obvious and localized
• Single file or 2-3 related files
• No architectural decisions needed
• Clear acceptance criteria from description

Use Standard When (Default)

• Multiple components affected
• Requires research or external docs
• Team needs context for review
• Has dependencies or risks

Use Comprehensive When

• New system or major feature
• Multiple phases of work
• Architectural decisions required
• Cross-cutting concerns (security, performance)
• Involves multiple teams or stakeholders

Plan Output

Write plans to: docs/plans/[YYYYMMDDHHMMSS]_<title>.md

Include in every plan:

• Research findings with file paths (e.g., src/models/user.rb:42)
• External documentation URLs
• Related issues/PRs if known
• Definition of Done from user input (populated from blueprint Step 2)

Conditional Sections

UI Features

Include "Design System Reference" section when feature involves:

• Pages, components, forms, buttons, modals
• Visual design elements

DevOps Features

Include "Infrastructure Context" section when feature involves:

• Terraform/OpenTofu, Ansible, cloud resources
• Docker, CI/CD, infrastructure

Anti-Patterns

Don't	Do
Use comprehensive for simple bugs	Match template to actual complexity
Skip acceptance criteria	Always include testable criteria
Leave placeholder text	Fill all sections or remove them
Over-plan obvious changes	Minimal template exists for a reason