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.