brainstorm-design

Generate codebase-grounded design options and pressure-test them with 25 questions.

Updated May 7, 2026
One-click install
npx skills add https://github.com/marktoda/cohesive --skill brainstorm-design-marktoda
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorm-design
Source: https://github.com/marktoda/cohesive/tree/main/skills/brainstorm-design
Command: npx skills add https://github.com/marktoda/cohesive --skill brainstorm-design-marktoda

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about brainstorm-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I brainstorm design options for a codebase refactor without breaking existing behavior?

Grounding codebase refactor brainstorming in existing specs and invariants ensures design options align with current system rules. This approach inventories existing behavior matrices and institutional knowledge before proposing 2–4 distinct, viable design directions.

What is substrate-grounded design exploration for software architecture?

Substrate-grounded design exploration automatically inventories a codebase's existing context, including specs, invariants, and gotchas, before generating architecture options. This mechanism ensures proposed changes maintain cohesion with existing system constraints rather than producing incoherent designs.

How do I evaluate and compare architecture changes for future fit and risk?

Evaluating architecture changes involves pressure-testing 2–4 credible design options against a 25-question battery covering cohesion, future fit, and risk. This structured evaluation recommends a single design direction with its main risk and structural mitigation explicitly identified.

Do I need existing codebase documentation to use substrate-grounded design brainstorming?

Substrate-grounded design brainstorming requires integration with a substrate discovery workflow to inventory existing codebase context. You need existing specs, invariants, behavior matrices, and institutional knowledge available to produce aligned, viable design options.

What's the best way to validate design options for codebase changes against existing invariants?

Validating design options against existing invariants requires pressure-testing each proposed change through a structured 25-question battery. This process checks cohesion, risk, and future fit before recommending a design direction, ensuring implementation aligns with codebase constraints.

When should I not use automated design brainstorming for new features?

Automated design brainstorming is not suitable when a substrate discovery workflow cannot inventory existing codebase context. Without access to existing specs, invariants, and behavior matrices, the tool cannot produce viable design options aligned with system constraints.