---
name: brainstorming-overlay
description: "Project-specific overlay for brainstorming. Adds decision-debate integration for complex technical decisions."
---

# Brainstorming Overlay (Project-Specific)

This overlay enhances `superpowers:brainstorming` with project-specific integrations.

## Integration: Decision Debate

When reaching the "Exploring approaches" phase of brainstorming and you identify **2+ distinct technical approaches**, follow this decision tree:

```
Is this a simple decision?
├─ YES (naming, minor style, single-file)
│   → Present options briefly, let user choose
│
└─ NO (architecture, technology, design pattern, performance/complexity trade-off)
    → Offer decision debate
```

### Trigger Phrases

Automatically offer decision-debate when you're about to say:
- "There are several ways to approach this..."
- "You could either X or Y..."
- "Option A vs Option B..."
- "The trade-offs are..."
- "It depends on whether you prioritize X or Y..."

### How to Offer

> "I've identified **[N] distinct approaches** for this:
> 1. **[Approach A]** - [1-sentence summary]
> 2. **[Approach B]** - [1-sentence summary]
>
> Would you like me to run a **decision debate**? I'll have:
> - Two agents argue for each approach (based on codebase analysis)
> - A staff engineer evaluate and recommend
>
> Or I can just summarize the trade-offs briefly."

### If User Chooses Debate

Invoke: `Skill: "decision-debate"`

### Decision Complexity Guide

| Complexity | Examples | Action |
|------------|----------|--------|
| **Low** | Variable naming, import order, comment style | Present briefly |
| **Medium** | Component structure, API design, test strategy | Offer debate |
| **High** | Architecture, database design, auth strategy | Strongly recommend debate |

## Project-Specific Considerations

For this codebase, these decisions often warrant debate:
- **Event sourcing patterns** - Aggregate boundaries, event design
- **API design** - REST structure, contract design
- **State management** - Local vs global, sync strategy
- **Performance** - Caching, query optimization, pagination
- **Security** - Auth flow, RLS policy, permission model