plan-builder skill

---
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
- **Acceptance Criteria** 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 |