brainstorming-extension

Brainstorming Extension - Mandatory Review Gate Bridge

Purpose

This skill bridges superpowers:brainstorming into the metaswarm quality pipeline by enforcing the Design Review Gate after any design document is created. Without this bridge, brainstorming flows directly into writing-plans, bypassing the 5-agent design review that catches architectural, security, and requirements issues before expensive implementation begins.

This is a critical workflow enforcement point, not a passive extension.

---

The Problem This Solves

superpowers:brainstorming has a built-in terminal state: "The ONLY skill you invoke after brainstorming is writing-plans." This creates a pipeline bypass:

WITHOUT this extension (broken flow):

superpowers:brainstorming
    └── Commits design doc
          └── writing-plans (DIRECTLY — no review!)
                └── executing-plans
                      └── Implementation begins on UNREVIEWED design

WITH this extension (correct flow):

superpowers:brainstorming
    └── Commits design doc
          │
          ▼
    ┌─────────────────────────────────────────┐
    │  MANDATORY DESIGN REVIEW GATE           │
    │  (Enforced by CLAUDE.md + start-task)   │
    │                                         │
    │  5 parallel review agents:              │
    │  • Product Manager (use cases)          │
    │  • Architect (architecture)             │
    │  • Designer (UX/API)                    │
    │  • Security Design (threats)            │
    │  • CTO (TDD readiness)                 │
    │                                         │
    │  ALL FIVE must APPROVE                  │
    └─────────────────────────────────────────┘
          │
          ▼
    ALL APPROVED? ────No────► Iterate on design (max 3)
          │
         Yes
          │
          ▼
    writing-plans → plan-review-gate → orchestrated-execution

---

How Enforcement Works

YAML frontmatter triggers (auto_activate, triggers) are metadata hints — Claude Code does not enforce them automatically. Instead, this enforcement works through three redundant mechanisms: