design

Generate and evaluate competing architectural design proposals for software features.

Updated Apr 1, 2021
One-click install
npx skills add https://github.com/danielukea/.dotfiles --skill design-danielukea
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/danielukea/.dotfiles/tree/main/claude/.claude/skills/design
Command: npx skills add https://github.com/danielukea/.dotfiles --skill design-danielukea

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps teams explore and compare different architectural approaches for a new feature, ensuring well-reasoned and robust design decisions before implementation.

Core Features & Use Cases

  • Architectural Exploration: Generates multiple competing design proposals for a given feature.
  • Codebase Analysis: Leverages existing codebase patterns and documentation to ground proposals.
  • Principle-Based Critique: Evaluates proposals against established software design principles.
  • Use Case: When starting a new feature, use this Skill to get 2-3 distinct architectural blueprints, complete with pros, cons, and a review against design best practices, helping you choose the optimal path forward.

Quick Start

Use the design skill to explore architectural approaches for the new user authentication feature.

Frequently Asked Questions about design

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

FAQPage Schema
How do I explore architectural design options for a new software feature?

To explore architectural design options, you provide a Basecamp todo URL, local markdown file, or interactive feature description. The tool analyzes your codebase context to generate multiple competing design proposals for evaluation.

What is the best way to compare architectural proposals against software design principles?

Comparing architectural proposals against software design principles is done by generating multiple distinct blueprints and evaluating them using principle-based critique. This process highlights the pros, cons, and best practices for each design path.

Can I use local markdown files for codebase analysis when planning feature architecture?

Yes, you can use local markdown files to provide context for codebase analysis during feature architecture planning. The system leverages existing codebase patterns and documentation from these files to ground its architectural design proposals.

Does architectural exploration work with Basecamp todo URLs as input?

Yes, architectural exploration works directly with Basecamp todo URLs as a valid input format. The system extracts the feature requirements from the URL to generate and evaluate competing architectural design proposals.

How does codebase analysis improve decision making for software design?

Codebase analysis improves software design decision making by grounding new feature proposals in your existing code patterns and documentation. This ensures generated architectural blueprints align with the current codebase context before synthesizing a final recommendation.

When should I avoid generating multiple competing design proposals for a feature?

You should avoid generating multiple competing design proposals when the feature scope is too narrow to warrant distinct architectural blueprints. The tool is designed for complex features requiring principle-based critique and codebase analysis to ensure robust design decisions.