brainstorm

Guides structured discovery dialogue through seven phases to produce a reviewed specification.

Updated May 31, 2026
One-click install
npx skills add https://github.com/AlexanderNarbaev/agi --skill brainstorm-alexandernarbaev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorm
Source: https://github.com/AlexanderNarbaev/agi/tree/main/.opencode/skills/brainstorm
Command: npx skills add https://github.com/AlexanderNarbaev/agi --skill brainstorm-alexandernarbaev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a fuzzy, exploratory idea into a concrete, testable specification is hard without structure. This Skill enforces a disciplined seven-phase brainstorm protocol that draws requirements out through dialogue, evaluates candidate approaches, and produces a reviewed spec before any planning begins. ## Core Features & Use Cases - Seven-Phase Protocol: Runs context scan, optional council advisory, one-question-at-a-time dialogue, approach comparison, design drafting, spec writing with reviewer sign-off, QA gate selection, and transition handling in strict order. - Clarification Funnel: Classifies uncertainties (self_resolved, critic_resolved, research_needed, user_decision, deferred) with an overconfidence guard and research timeout so only true blockers surface as [NEEDS CLARIFICATION] markers. - Mandatory QA Gate Dialogue: Presents eleven QA gates, parallel coder count, commit frequency, and auto-proceed as one unified user decision, recording elections in .swarm/context.md before planning. - Use Case: A user says "help me think through adding real-time collaboration to our app." The Skill maps the codebase, asks focused questions with defaults, presents 2-4 architectural approaches, drafts a WHAT/WHY spec reviewed by an independent reviewer, and captures QA gate choices before handing off to planning. ## Quick Start Ask the agent to brainstorm your feature idea, for example by saying "let's brainstorm adding audit logging to the admin panel," and answer the focused questions it asks one at a time.

Frequently Asked Questions about brainstorm

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

FAQPage Schema
How do I turn a vague feature idea into a specification?

Invoke the brainstorm mode with your topic. It scans the codebase, asks up to six focused questions with informed defaults, presents 2-4 candidate approaches, then drafts a WHAT/WHY spec with FR/SC numbering that an independent reviewer must approve.

When should I use brainstorm mode instead of specify mode?

Use brainstorm when requirements are fuzzy and need to be drawn out through structured dialogue. Use specify when you have already articulated clear requirements and want to skip the discovery phases.

What QA gates can I enable during brainstorm?

Eleven gates are presented: reviewer, test_engineer, sme_enabled, critic_pre_plan, sast_enabled, council_mode, hallucination_guard, mutation_test, phase_council, drift_check, and final_council. You choose them together with parallel coder count and commit frequency in one exchange.

Can the brainstorm phases be skipped or reordered?

No. The seven phases run in strict order and each has an explicit exit condition that must be met before moving on. The dialogue phase also enforces one question per message, except the unified QA gate selection exchange.

What happens when a clarification question cannot be resolved?

Uncertainties pass through a funnel: self-resolved items become assumptions, research-needed items get a configurable timeout (default 5 minutes), and survivors surface as [NEEDS CLARIFICATION] markers with recommended defaults and blocking status.