Why does the skill only ask one question at a time?

Asking one question at a time prevents cognitive overload and ensures that every specific requirement or constraint is carefully considered and confirmed.

How does this skill handle complex architectural decisions?

It proposes 2-3 different approaches for any given feature, detailing the trade-offs regarding complexity, performance, and maintainability to help you choose the best fit.

What is the 'Iron Law' of this skill?

The Iron Law states: 'No implementation without design agreement first.' This ensures that developers and the AI are fully aligned on the approach before any production code is written.

Does it create documentation automatically?

Yes, once a design is validated, the skill automatically writes a detailed design document to your repository's docs/plans directory and commits it.

When should I use the Design Exploration skill?

It is mandatory before creating new features or components, and highly recommended before significant behavior changes or complex refactoring.

Design Exploration & Software Architecture

Name: Design Exploration & Software Architecture
Author: jagreehal

byjagreehal

0•

Productivity & Workflow

Guides collaborative software design sessions through structured questioning to validate requirements before writing code.

The Design Exploration skill transforms vague ideas into concrete technical plans by enforcing a 'design first' methodology within Claude Code. It prevents wasted effort and technical debt by guiding the developer through a structured five-phase process: understanding context, clarifying intent with focused questions, exploring multiple architectural approaches with trade-offs, presenting modular design sections, and documenting the final agreement. By prioritizing YAGNI principles and requiring explicit design validation, it ensures that every line of code written has a clear purpose and architectural fit.

Key Features

010 GitHub stars

02Automated generation of standardized design documents in Markdown

03Structured five-phase design process from context to documentation

04Mandatory trade-off analysis for 2-3 distinct architectural approaches

05Interactive multiple-choice requirement gathering to reduce ambiguity

06Strict YAGNI enforcement to prevent unnecessary feature creep

Use Cases

01Defining the architecture for a new feature or component before implementation

02Documenting technical decisions and data flows for long-term maintainability

03Clarifying ambiguous requirements through focused, one-at-a-time questioning

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jagreehal/jagreehal-claude-skills design-exploration

For use in Claude.ai and ChatGPT

Download Skill