brainstormer

BrainStormer

The AI Development Operating System

Drop into any project. Run init. Ship.

Your AI assistant forgets everything between sessions. BrainStormer remembers. Rules compound. Patterns accumulate. Your 100th session is 10x faster than your first.

Quick Start

pip install brainstormer
cd your-project
brainstormer init

That's it. BrainStormer detects your stack, scaffolds 10 project docs, wires up all 4 skills, and starts learning from your code.

Detecting project...          Next.js + TypeScript + Supabase
Scaffolding project docs...   10 created, 0 existing
Setting up comprehension...   CodeGlass ready
Setting up ideation...        BrainStormer ready
Setting up quality gates...   PALADIN ready
Syncing to Obsidian...        Done

Done! Project 'my-app' is ready.

For Developers AND Vibe Coders

Never coded before? BrainStormer helps you understand what AI builds for you. Every code output gets a plain-English walkthrough. Rules accumulate so the AI stops making the same mistakes. You don't need to be a developer to use this.

What It Does

BrainStormer consolidates 4 AI-assisted development skills into one system:

1. Kernel — 10 template files that give AI agents persistent context about your project
2. Comprehension — Every code output gets a WHAT/HOW/WHERE/WHEN/WHY walkthrough
3. Ideation — Turn one idea into 20+ ranked angles, hooks, calendars, and outlines
4. Quality — 6-tier testing wall that catches dumb problems before you debug subtle ones

Plus 374 curated agents, self-learning rules, team rulesets, git hooks, and an Obsidian dashboard that shows everything across all your projects.

Commands

Core

brainstormer init              # Set up project (detects stack, scaffolds docs)
brainstormer status            # Health score, knowledge stats, recommendations
brainstormer doctor            # Validate setup, diagnose issues
brainstormer sync              # Sync project state to/from Obsidian vault
brainstormer help              # Full help

Self-Learning (auto-compounds knowledge)

brainstormer learn status      # Show rules, confidence, hit/miss stats
brainstormer learn rule --from-diff HEAD~1   # Auto-propose rules from git diff
brainstormer learn walkthrough --from-diff   # Generate walkthrough from commits
brainstormer learn scan --detect             # Detect recurring patterns
brainstormer learn prune                     # Flag stale or low-confidence rules
brainstormer summary                         # Auto-generate daily Obsidian journal

Agents

brainstormer agent list        # Show agents for your stack (374 total)
brainstormer agent search      # Search agents by keyword
brainstormer agent info        # Show agent details
brainstormer agent create      # Scaffold a custom agent (Pro)
brainstormer agent run         # Run a multi-agent pipeline (Pro)

Team

brainstormer team templates    # List 6 starter rule templates
brainstormer team status       # Show team ruleset info
brainstormer team apply        # Apply a stack-specific template (Pro)
brainstormer team init         # Create shared team ruleset (Pro)

Automation

brainstormer hooks install     # PALADIN pre-commit + auto-learn post-commit
brainstormer hooks context     # Show rules relevant to current changes
brainstormer hooks status      # Show hook installation status

System

brainstormer update            # Check for updates + re-sync templates
brainstormer update channel    # View/set release channel (stable/preview)
brainstormer update rollback   # Revert to previous version
brainstormer migrate           # Import .cursorrules, .windsurfrules, etc.
brainstormer license           # Show/activate/deactivate license
brainstormer license buy       # Open Pro checkout page
brainstormer telemetry         # Toggle anonymous usage telemetry

The Four Skills

Kernel (Priority 1)

Scaffolds 10 markdown files that give AI agents persistent project context:

Comprehension (Priority 2)

Every code output gets a walkthrough: WHAT (one sentence) → HOW (data flow) → WHERE (file map) → WHEN (triggers) → WHY (design choices)

Ideation (Priority 3)

6-step chain: Audience Lock → Core Extraction → Hook + Format Match → Calendar Build → Outline Expansion → Skill Deposit

Quality (Priority 4)

6-tier testing wall — catch the dumbest problems first:

374 Agents

Curated from 4 community sources. Smart surfacing shows relevant agents for your detected stack.

• community — Community-sourced collection
• wshobson/agents — Community collection
• VoltAgent/awesome-claude-code-subagents — Curated subagents
• 0xfurai/claude-code-subagents — Production-ready agents

Obsidian Integration

YourVault/
├── Home.md                    # All-projects dashboard
├── projects/
│   └── YourProject/
│       ├── dashboard.md       # One-page overview
│       ├── spec.md
│       ├── architecture.md
│       ├── ideation/
│       ├── comprehension/
│       └── quality/
├── journal/                   # Daily summaries with keyword linking
├── rules/                     # Cross-project rules
└── agents/                    # Agent catalog

Configure: brainstormer config set vault_path /path/to/vault

Pricing

First 100 members get $12/mo locked forever. Get Pro

Support

• Discord — questions, bugs, feature requests
• GitHub Issues — bug reports

License

MIT — Patrick McGuire