reversa-brainstorm

Orchestrates a multi-stage ideation pipeline that clarifies raw ideas before development begins.

1.5k|405|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-brainstorm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-brainstorm
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-brainstorm
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-brainstorm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Raw ideas often jump straight into code without structured thinking, leading to poorly framed problems and missed risks. This Skill orchestrates the Reversa Ideation Team to clarify an idea through framing, divergence, premortem analysis, and convergence before any development artifact exists.

Core Features & Use Cases

  • Structured Ideation Pipeline: Routes an idea through five stages (framing, options, risks, decision, pre-spec), each producing a traceable Markdown artifact in the brainstorms folder.
  • Session Management: Detects in-progress ideation sessions via active-ideation.json, resumes from the correct stage based on files on disk, and supports parallel sessions.
  • Context Detection: Works in both greenfield projects and legacy codebases with existing Reversa reverse-engineering extractions, anchoring ideation in what was already mapped.
  • Use Case: Before building a new feature on a legacy system, run the brainstorm to separate the problem from the solution, explore multiple approaches, attack the assumptions with a premortem, and hand off a decided pre-spec to the requirements pipeline.

Quick Start

Ask the agent to run /reversa-brainstorm and describe your idea in one or two sentences to start a guided ideation session.

Frequently Asked Questions about reversa-brainstorm

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

FAQPage Schema
How do I structure an idea before writing code with an AI agent?

Run /reversa-brainstorm and describe your idea in one or two sentences. The orchestrator routes it through framing, option exploration, premortem risk analysis, and a final decision, producing a pre-spec document ready for the development pipeline.

What artifacts does the Reversa ideation pipeline produce?

Each stage writes one Markdown file in the session folder: framing.md, options.md, risks.md, decision.md, and pre-spec.md. These artifacts are traceable and feed directly into downstream Reversa commands like /reversa-new or /reversa-requirements.

Can I use the brainstorm skill on a legacy codebase?

Yes. The orchestrator detects whether a Reversa reverse-engineering extraction exists in the output folder. In legacy contexts it anchors ideation in the already-mapped specifications; in greenfield contexts it operates only on what you provide.

How do I resume an interrupted brainstorm session?

The orchestrator reads .reversa/active-ideation.json and the files on disk to detect the current stage. It offers a menu to continue where you left off, start a parallel session, or reopen a specific stage.

Which AI agents are compatible with this skill?

The skill declares compatibility with Claude Code, Codex, Cursor, Gemini CLI, and other agents supporting the Agent Skills format. It is installed by the Reversa installer into .agents/skills/ and .claude/skills/.