spec-driven-brainstorm

Convert conversational product intent into an issue-organized spec.md with absolute acceptance facts.

77|15|Updated May 12, 2026
One-click install
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill spec-driven-brainstorm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-driven-brainstorm
Source: https://github.com/Waterball-Software-Academy/aixbdd/tree/main/.agents/skills/spec-driven-brainstorm
Command: npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill spec-driven-brainstorm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents vague AI brainstorming by converting conversational ideation into a structured, boundary-aware spec written as absolute, acceptance-grade truth.

Core Features & Use Cases

  • Issue-organized spec building: Breaks work into numbered issues and progressive disclosure subsections to keep decisions coherent.
  • Absolute, non-hedged writing: Rewrites inputs into confirmable facts with strict “as-is” constraints (no hedging, no Q&A, no transitional narratives).
  • Brainstorming commitment + archiving: Forces selected solutions to be committed while archiving prior brainstorming verbatim for auditability.
  • Consistency maintenance: Detects contradictions after each update and cascades revisions within the same issue when upstream changes occur.
  • Guided user clarification: Uses batch questions when intent is ambiguous or when a jump would violate the disclosure order.

Quick Start

Run spec-driven-brainstorm and tell the AI what you want to build, then reply to each prompt to grow spec.md from Definition → Problem Space → Brainstorming → Solution → Examples → Implementation.

Frequently Asked Questions about spec-driven-brainstorm

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

FAQPage Schema
How do I turn product brainstorming into structured acceptance criteria?▼

Spec-driven brainstorming converts conversational intent into an issue-organized spec.md containing boundary-aware, absolute acceptance criteria, ensuring vague ideation becomes confirmable product facts.

What is the best way to maintain consistency when revising product requirements?▼

Maintain consistency by detecting contradictions after each update and cascading revisions within the same issue, ensuring upstream changes automatically propagate through the spec.

How do I write a specification with progressive disclosure for product discovery?▼

Grow the spec.md progressively through ordered subsections—Definition, Problem Space, Brainstorming, Solution, Examples, and Implementation—using batch questions to guide clarification and maintain disclosure order.

Can I archive brainstorming sessions for auditability before committing to a solution?▼

Yes, atomic archiving saves prior brainstorming verbatim upon variant commit, forcing selected solutions to be committed while preserving the entire ideation history for auditability.

Why does my AI-generated specification contain hedging and transitional narratives?▼

Specifications contain hedging when strict as-is style constraints are absent; applying absolute, non-hedged writing rules rewrites inputs into confirmable facts without Q&A or transitional narratives.

Does spec-driven brainstorming work without external dependencies?▼

Spec-driven brainstorming operates with zero external dependencies, relying solely on conversational prompts to resolve ambiguity via batch questions and maintain spec invariants throughout multi-round ideation.