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.