Which architecture patterns does this skill support?

It provides guidance on Layered Architecture, Clean Architecture, Hexagonal (Ports & Adapters), Event-Driven Architecture, and CQRS (Command Query Responsibility Segregation).

Does this skill help with technical documentation?

Yes, it includes a Trade-off Analysis template and an Architecture Decision workflow to help document why specific technical paths were chosen.

Is this suitable for both small and large teams?

Absolutely. It includes specific recommendations tailored to team sizes, ranging from solo developers (Monoliths) to teams of 10+ (Modular Monoliths or Microservices).

How do I choose the right directory structure?

The skill recommends a Layer-based structure for simple apps and a Feature-based structure for medium to large-scale applications to ensure better modularity.

Software Architecture Design

Name: Software Architecture Design
Author: Tahir-yamin

byTahir-yamin

•

API開発

Designs robust software architectures and selects optimal patterns based on project scale, team constraints, and technical requirements.

概要

The Designing Architecture skill provides a structured framework for building maintainable and scalable software systems. It guides developers through the selection of architectural patterns—such as Clean Architecture, Hexagonal (Ports & Adapters), and CQRS—while providing specific directory structure recommendations and decision-making templates. By following its validated workflows, teams can document technical trade-offs, ensure proper separation of concerns, and align their system design with project size and team capabilities.

主な機能

Size-based directory structure templates for both simple and complex projects
Validation checklists to ensure dependency rules and module boundaries are maintained
3 GitHub stars
Comprehensive Architecture Decision Record (ADR) and trade-off analysis templates
Step-by-step design workflow from requirements gathering to validation
Pattern selection guides for Clean, Hexagonal, Event-Driven, and CQRS architectures

ユースケース

Onboarding new team members with standardized directory patterns and architectural documentation
Restructuring a growing codebase to improve testability and maintainability
Choosing between a Modular Monolith or Microservices for a new enterprise project

概要

主な機能

Size-based directory structure templates for both simple and complex projects
Validation checklists to ensure dependency rules and module boundaries are maintained
3 GitHub stars
Comprehensive Architecture Decision Record (ADR) and trade-off analysis templates
Step-by-step design workflow from requirements gathering to validation
Pattern selection guides for Clean, Hexagonal, Event-Driven, and CQRS architectures

ユースケース

Onboarding new team members with standardized directory patterns and architectural documentation
Restructuring a growing codebase to improve testability and maintainability
Choosing between a Modular Monolith or Microservices for a new enterprise project