design-architect

What problem does it solve?

Design teams often produce inconsistent design documents, leading to miscommunication, rework, and missed requirements. This Skill defines a standardized approach to creating and reviewing technical design documents for software systems.

Core Features & Use Cases

• Template-driven design docs: Provides a clear structure for Overview, Architecture, Components & Interfaces, Data Models, and Validation criteria.
• Guided design reviews: Establishes checklists and tracing of requirements to design elements to ensure completeness and traceability.
• Enterprise-architecture alignment: Helps align project designs with architectural principles and best practices across teams.
• Use Case: A team drafts a system design for a new payments service using the standard template and review workflow, ensuring all critical decisions are documented.

Quick Start

Create a new design document named design.md following the standard template, populate Overview, Architecture, Components and Interfaces, and Data Models, and then run through the design-review checklist.