# Brainstorm

> Open-source AI coding assistant ecosystem with intelligent multi-model routing.
> Built by Justin Gilg (JJ) with Claude as the primary technical decision-maker.

## Products

### Brainstorm CLI (@brainstorm/cli)
Open-source AI coding assistant with intelligent multi-model routing.
- 24-package TypeScript monorepo (Turborepo)
- 42+ built-in tools across 11 categories (filesystem, shell, git, GitHub, web, planning, agents, transactions, BR intelligence)
- 10 built-in MCP servers (Playwright, GitHub, Slack, Linear, Jira, Notion, Datadog, AWS, Stripe, filesystem)
- 8 subagent types (explore, plan, code, review, general, decompose, research, external)
- 5 roles: architect, sr-developer, jr-developer, product-manager, qa
- 6 routing strategies including Thompson sampling (multi-armed bandit)
- 4-mode terminal TUI: Chat, Dashboard, Models, Config
- @brainstorm/sdk for programmatic access
- storm ingest: drops into any codebase, generates docs + AI infrastructure
- License: Apache-2.0
- Install: npm install -g @brainstorm/cli
- GitHub: https://github.com/justinjilg/brainstorm
- npm: https://www.npmjs.com/package/@brainstorm/cli

### BrainstormRouter
Multi-tenant AI API gateway and intelligence layer.
- 362 model endpoints across 30+ providers
- 13 intelligence systems (Thompson sampling, semantic cache, budget forecasting, streaming guardrails, tool firewall, PII detection, prompt injection detection, evidence ledger, 4-block memory, model ranking, routing advisor, agent identity, compliance)
- SPIFFE agent identity with 5-minute ephemeral mTLS certificates
- Streaming token-by-token guardrails (unique in market)
- Semantic tool firewall with deep intent inspection
- < 5ms p95 gateway latency overhead
- OpenAI-compatible API at api.brainstormrouter.com
- Positioned as "Active Directory for AI agents"

### BrainstormLLM v2
Sequential predictor trained on 2,203 orchestration trajectories.
- 0.796 F1 accuracy on phase prediction
- ONNX export for sub-2ms inference
- Learns optimal 9-phase development pipelines

### @brainstorm/sdk
TypeScript SDK for programmatic access to Brainstorm.
- Brainstorm class with run(), classify(), analyze(), generateDocs()
- Install: npm install @brainstorm/sdk

## Key Differentiators
- Claude is the primary technical decision-maker (not just a tool — co-architect)
- Only AI gateway with streaming token-by-token guardrails
- Thompson sampling learns optimal model routing from real production outcomes
- SPIFFE agent identity (5-min ephemeral certs, not static API keys)
- storm ingest: one command to generate full AI infrastructure for any codebase

## Case Studies
- BrainstormMSP: 37 AI agents, 93% auto-heal rate (autonomous MDR for MSPs)
- Brainstorm-GTM: 70 agents, autonomous go-to-market ($24.67M target MRR)
- Peer10: Youth sports platform with God-Mode UX ($113.6B market)
- Lead Network: 33 domains, 7 verticals, fully autonomous acquisition

## SDLC Framework
Brainstorm includes a hallucination-proof SDLC framework:
- 14 development phases from discovery to maintenance
- 12 virtual roles with anti-hallucination safeguards
- 5-layer verification: ground truth, evidence chain, forensic verification, multi-agent consensus, human-in-the-loop
- Forensic subagent independently verifies every claim against the real codebase
- Multi-agent consensus uses different models (Opus, Gemini, GPT-5) to prevent groupthink
- Full documentation: https://brainstorm.co/cli/docs/sdlc-matrix

## Links
- Website: https://brainstorm.co
- CLI Docs: https://brainstorm.co/cli/docs
- Router Docs: https://brainstorm.co/router/docs
- SDLC Matrix: https://brainstorm.co/cli/docs/sdlc-matrix
- GitHub: https://github.com/justinjilg/brainstorm
- npm: https://www.npmjs.com/package/@brainstorm/cli
- API: https://api.brainstormrouter.com