design-decisions

What problem does it solve?

This skill forces documentation of the reasoning behind every significant design decision. It creates a decision log that explains WHY choices were made, alternatives considered, and trade-offs accepted, preventing unjustified "default" choices.

Core Features & Use Cases

• Maintains a structured decision log template for auditing and onboarding.
• Forces explicit rationale, alternatives, and trade-offs for major design choices.
• Improves collaboration by making design reasoning accessible to product, engineering, and design teams.
• Covers typography, color, spacing, layout, motion, and components, enabling consistent decision recording across projects.
• Provides validation checks and red-flag prompts to maintain high-quality documentation.

Quick Start

Activate the design-decisions skill and start a new decision log with a unique identifier. Document decisions by filling in the metadata, decisions, and unresolved sections using the decision template. Review the validation questions to ensure completeness and traceability.