Brainstorming & Design Specification

About

This skill facilitates a collaborative design process between the developer and Claude to ensure features are fully thought out before implementation begins. It guides users through project context discovery, explores multiple architectural approaches with pros and cons, and validates designs incrementally in small, digestible sections. By enforcing a 'one question at a time' rule and adhering to YAGNI principles, it eliminates ambiguity and over-engineering, resulting in a finalized, documented design plan committed directly to your repository.

Key Features

• Context-aware discovery via project file and history analysis
• Iterative questioning to refine intent without overwhelming the user
• Automated documentation generation and Git commitment of design specs
• Incremental design validation in 200-300 word sections
• Comparative analysis of 2-3 technical approaches with trade-offs
• 3 GitHub stars

Use Cases

• Converting high-level requirements into actionable technical documentation
• Architecting a new feature or complex component from scratch
• Refactoring existing functionality by exploring alternative implementation patterns