What problem does it solve?
Brainstorming code changes (new features, refactors, architecture updates) often produces design options that ignore a codebase's existing specs, invariants, rules, and institutional knowledge, leading to incoherent changes that break existing behavior or require costly rework. This skill eliminates that risk by grounding all design exploration in the codebase's existing substrate to produce viable, aligned options.
Core Features & Use Cases
- Substrate-grounded exploration: Automatically inventories existing codebase context (specs, invariants, behavior matrices, gotchas) before generating design options to ensure alignment with existing system rules.
- Structured option evaluation: Proposes 2–4 distinct, credible design options and pressure-tests each against a 25-question battery covering cohesion, future fit, and risk.
- Actionable recommendation: Recommends a single design direction with explicit main risk, structural mitigation, and a list of required substrate updates before implementation.
- Use cases: Ideal for brainstorming new features, planning refactors, evaluating architecture changes, or validating design options for any codebase change to ensure alignment with existing system constraints.
Quick Start
Use the brainstorm-design skill to explore viable design options for refactoring the user intake classification system, grounded in your codebase's existing specs and invariants.