design-architect

Standardize technical design documents with templates and review checklists.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/jralph/.config-opencode --skill design-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-architect
Source: https://github.com/jralph/.config-opencode/tree/main/skills/design-architect
Command: npx skills add https://github.com/jralph/.config-opencode --skill design-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about design-architect

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

FAQPage Schema
How do I standardize technical design documents to reduce rework?

Standardize technical design documents by applying a fixed template covering Overview, Architecture, Components, Interfaces, Data Models, and Validation criteria. This structured approach reduces ambiguity, ensures traceability of requirements, and aligns project designs with architectural principles.

What should be included in a system design template for software architecture?

A system design template should include sections for Overview, Architecture, Components and Interfaces, Data Models, and Validation criteria. Defining these components standardizes architecture definitions and component interactions to ensure completeness and clarity across software projects.

How do I conduct a design review for a new software service?

Conduct a design review by running through a standardized checklist that traces requirements directly to design elements. This guided review process ensures completeness, verifies alignment with architectural principles, and identifies missing requirements before implementation begins.

Can I use this approach to align project designs with enterprise architecture best practices?

Yes, you can align project designs with enterprise architecture by using standardized templates and review workflows. This ensures technical decisions for systems like a payments service are documented clearly and adhere to established architectural principles across teams.

What is the best way to document component interactions and data models?

The best way to document component interactions and data models is by populating a standardized design document template. Specifying these sections ensures clear traceability of system architecture and reduces miscommunication during software development.