system-design

Guide architecture design for new CRs, projects, and ARCHITECTURE.md updates.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/dsivov/ai_development_team --skill system-design-dsivov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design
Source: https://github.com/dsivov/ai_development_team/tree/main/.claude/skills/system-design
Command: npx skills add https://github.com/dsivov/ai_development_team --skill system-design-dsivov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architects often struggle to design scalable, well-documented systems and select appropriate patterns.

Core Features & Use Cases

  • Guidance for identifying components, data models, APIs, and deployment considerations.
  • Templates and best practices for architecture documentation (ARCHITECTURE.md) and design decisions.
  • Patterns and decision frameworks to balance performance, security, and maintainability.

Quick Start

Provide your project goals and constraints to receive a structured system design plan.

Frequently Asked Questions about system-design

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

FAQPage Schema
How do I document system architecture for a new project?

To document system architecture, you need to outline components, data models, interfaces, API design, dependencies, and scalability decisions. This Skill provides structured templates and best practices to generate an ARCHITECTURE.md file for new projects.

What patterns should I use for scalable architecture design?

Scalable architecture design requires patterns that balance performance, security, and maintainability. You can apply decision frameworks to evaluate technology and select appropriate patterns based on your specific project goals and constraints.

How do I structure an ARCHITECTURE.md file for components and data models?

An ARCHITECTURE.md file should document components, data models, interfaces, API design, dependencies, and scalability decisions. You can use structured guidance to map out deployment considerations and capture these architecture decisions systematically.

Can I use this for technology evaluation and API design?

Yes, you can use this for technology evaluation and API design. It provides decision frameworks to assess technology choices and offers structured guidance for defining interfaces, data models, and deployment considerations.

When do I need structured guidance for system design?

You need structured guidance for system design when creating new change requests, evaluating technologies, or updating ARCHITECTURE.md. It helps balance performance, security, and maintainability while ensuring all components and dependencies are documented.

How do I balance performance and maintainability in system design?

To balance performance and maintainability in system design, apply patterns and decision frameworks that evaluate trade-offs. You can input project goals and constraints to receive a structured plan that documents these architectural decisions.