Can it generate visual architecture diagrams?

Yes, the skill can automatically generate Mermaid-based Entity Relationship Diagrams (ERD), sequence diagrams, and flowcharts based on your conversation.

Does it support specific technical scenarios?

Yes, it includes specialized templates for API integrations, data migrations, and performance optimization to ensure relevant constraints are considered.

How does the AI assist during the session?

By using the 'suggest' command, the AI provides contextual advice, identifies potential architectural pitfalls, and suggests industry-standard patterns for your specific problem.

What is a Brainstorm Solution session?

It is an interactive, guided process within Claude Code that helps you explore all technical aspects of a feature—from data models to security—before you start writing code.

Where are the brainstorming results stored?

All progress is automatically saved to a structured directory in your project under docs/tech-brainstorm/, ensuring your architectural decisions are version-controlled.

Brainstorm Solution

Name: Brainstorm Solution
Author: jpoutrin

byjpoutrin

•

Productivity & Workflow

Guides developers through structured technical brainstorming sessions to architect robust software solutions within Claude Code.

Brainstorm Solution is a specialized design skill that bridges the gap between a problem statement and a technical specification. It provides an interactive, multi-step framework that prompts developers to consider data models, system components, API designs, and architectural trade-offs. By leveraging AI-powered suggestions and automated Mermaid diagram generation, it helps engineering teams explore various implementation paths, identify potential pitfalls early, and document the entire decision-making process in a standardized, version-controlled format.

Key Features

01Automated Mermaid diagram generation for ERDs, flowcharts, and sequence diagrams.

02AI-powered contextual suggestions for best practices and architectural patterns.

03Predefined templates for API integration, data migration, and performance optimization.

04Automatic session documentation with markdown summaries and decision logs.

05Interactive multi-section brainstorming covering data models, components, and security.

068 GitHub stars

Use Cases

01Architecting a new feature from a high-level product brief to identify technical requirements.

02Facilitating technical discovery sessions to document trade-offs before starting implementation.

03Planning complex third-party API integrations with focus on error handling and rate limits.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoutrin/product-forge brainstorm-solution

For use in Claude.ai and ChatGPT

Download Skill