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 Development

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.

Key Features

01Size-based directory structure templates for both simple and complex projects

02Validation checklists to ensure dependency rules and module boundaries are maintained

033 GitHub stars

04Comprehensive Architecture Decision Record (ADR) and trade-off analysis templates

05Step-by-step design workflow from requirements gathering to validation

06Pattern selection guides for Clean, Hexagonal, Event-Driven, and CQRS architectures

Use Cases

01Onboarding new team members with standardized directory patterns and architectural documentation

02Restructuring a growing codebase to improve testability and maintainability

03Choosing between a Modular Monolith or Microservices for a new enterprise project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tahir-yamin/dev-engineering-playbook designing-architecture

For use in Claude.ai and ChatGPT

Download Skill