Agent skill · software engineering · aiskillstore
software-architecture
Clean Architecture and SOLID principles guide. Use this when designing systems, reviewing architecture, or making structural decisions.
Why this skill is useful
Provides domain-specific architectural patterns and principles that the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Software Architecture Clean Architecture와 DDD 원칙 기반 소프트웨어 설계 가이드입니다. Core Principles SOLID 원칙 설명 예시 ------ ------ ------ Single Responsibility 하나의 클래스는 하나의 책임 UserRepository vs UserService Open/Closed 확장에 열림, 수정에 닫힘 인터페이스 사용 Liskov Substitution 하위 타입은 상위 타입 대체 가능 상속 계약 준수 Interface Segregation 클라이언트별 인터페이스 분리 IReader vs IWriter Dependency Inversion 추상화에 의존 DI 컨테이너 사용 Clean Architecture Layers 의존성 규칙: 바깥 → 안쪽 방향으로만 의존 Code Style Rules Early Return Pattern Function/File Size Limits 대상 권장 최대 조치 ------ ------ ------ ------ 함수 30줄 50줄 분리 컴포넌트 80줄 150줄 분리 파일 200줄 300줄 모듈화 Domain-Specific Naming Library-First Approach "모든 커스텀 코드는 유지보수, 테스트, 문서화가 필요한 부채다" 코드 작성 전 확인: 1. npm/yarn 패키지 검색 2. 기존 서비스/API 확인 3. 오픈소스 솔루션 검토 Anti-Patterns to Avoid Anti-Pattern 문제점 해결책 -------------- -------- -------- NIH Syndrome 바퀴 재발명 라이브러리 우선 God Class 너무 많은 책임 SRP 적용 Spaghetti Code 얽힌 의존성 레이어 분리 Magic Numbers 의미 불명확 상수 추출 Deep Nesting 가독성 저하 Early Return Separation of Concerns Decision Checklist 새로운 코드 작성 시: [ ] 기존 라이브러리/서비스로 해결 가능? [ ] 단일 책임 원칙 준수? [ ] 의존성 방향 올바름? [ ] 테스트 가능한 구조? [ ] 도메인 네이밍 사용?
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/software-architecture--5f3b9c