Skip to content

v2.15.0 — Brainstorm v2.5.0: Spec Simplification + Smart Questions

Choose a tag to compare

@Data-Wise Data-Wise released this 06 Feb 18:23
· 219 commits to main since this release
bbd6ac7

Brainstorm v2.5.0: Spec Simplification + Smart Questions

Spec Simplification (84% reduction)

  • Brainstorm command spec: 1,919 → 312 lines (84% reduction)
  • Extracted to 4 reference documents:
    • docs/specs/SPEC-brainstorm-question-bank.md — Full question bank with all Q&A text
    • docs/tutorials/TUTORIAL-brainstorm-power-user.md — Power user guide with advanced patterns
    • docs/reference/REFCARD-BRAINSTORM.md — Quick reference card with flowchart
    • docs/VERSION-HISTORY.md — Brainstorm evolution table (v2.1→v2.5)

Context-Aware Smart Questions

  • New utility: utils/brainstorm_context.py (~280 lines)
    • Scans .STATUS, docs/specs/, git log, CLAUDE.md for project context
    • Pre-fills answers from existing project state
    • Detects prior brainstorms, matching specs, failing tests
  • Project-type question extensions: 6 types (R, Python, Node.js, Quarto, Claude Plugin, Teaching) with 12 new questions
  • Dynamic questions: Matching spec detection, prior brainstorm resume, failing test alerts

Tests

  • 38 new tests in tests/test_brainstorm_context.py (all passing)
  • 53 + 24 existing brainstorm tests verified
  • 1286 total tests across the project

Documentation

  • 3 new nav entries in mkdocs.yml
  • Version refs synced across README, docs/index.md, CLAUDE.md, mkdocs.yml
  • All CI checks passing

Full Changelog: v2.14.0...v2.15.0