pair-brainstorm

Guide structured research and formal specification for architectural decisions.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/NooBat/claude --skill pair-brainstorm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pair-brainstorm
Source: https://github.com/NooBat/claude/tree/main/skills/pair-brainstorm
Command: npx skills add https://github.com/NooBat/claude --skill pair-brainstorm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pair Brainstorm provides a structured, research-first approach to architectural and product decisions, helping teams surface assumptions, challenge weak ideas, and convert discussion into a concrete spec with ADRs.

Core Features & Use Cases

  • Structured Phase-driven workflow (Phase 1: quick research; Phase 2: adversarial design; Phase 3: documentation; Phase 4: handoff)
  • Adversarial questioning to surface edge cases and refine requirements
  • Generates a complete spec with MVP user stories and acceptance criteria
  • Creates ADRs when alternative approaches warrant long-term justification
  • Handoff-ready outputs for review, planning, and execution (/plan)

Quick Start

Initiate Phase 1 research, synthesize findings into a complete spec with ADRs, and prepare for the spec review loop.

Frequently Asked Questions about pair-brainstorm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architectural decisions and evaluate design options?▼

To document architectural decisions, use a structured, research-first evaluation process that applies adversarial questioning to surface edge cases. This converts design discussions into a concrete specification and creates Architecture Decision Records for long-term justification.

What is a devil's-advocate design review and how does it refine specifications?▼

A devil's-advocate design review is an adversarial questioning phase that challenges weak ideas and surfaces hidden assumptions. It refines specifications by forcing a structured evaluation of constraints, edge cases, and alternative approaches before finalizing scope.

How do I write MVP user stories and acceptance criteria from architecture brainstorming?▼

Writing MVP user stories from architecture brainstorming requires a phase-driven workflow that synthesizes research into a formal specification. It captures the clear WHAT, constraints, and acceptance criteria necessary for handoff-ready planning and execution.

When do I need an ADR vs a full specification for feature scope?▼

You need an ADR when alternative architectural approaches warrant long-term justification, while a full specification is required to define the MVP-focused scope, constraints, and acceptance criteria for immediate execution.

Can I use risk analysis to surface edge cases in software design?▼

Yes, risk analysis is integrated into the adversarial design phase to actively surface assumptions and edge cases. This forces teams to evaluate several options and capture the resulting constraints within a structured specification.

What's the best way to prepare for a structured design review handoff?▼

The best way to prepare for a design review handoff is to complete a four-phase workflow: conduct quick research, apply adversarial questioning, generate formal documentation, and produce handoff-ready outputs for planning.