소프트웨어 아키텍처 가이드라인

SKILL.md

---
name: 소프트웨어 아키텍처 가이드라인
description: 시스템 경계, 품질 요구사항, 통신, 스타일, 결정, 위험 또는 진화를 분석할 때 상황에 맞는 소프트웨어 아키텍처 지침을 적용하세요.
---

# 소프트웨어 아키텍처 가이드라인

이 휴대용 초안을 사용하여 소프트웨어 도메인 전반에 걸친 아키텍처 작업을 지원하세요. 전역에 설치되지 않습니다. 이 책은 개념과 절충안을 제공하며, 이 가이드는 이를 조건부 검사로 운영화합니다. 이들은 프로젝트 명령이나 사용자 의도, 지역 거버넌스, 알려진 시스템 증거를 대체하지 않습니다.

## 워크플로우

1. **컨텍스트와 권한 설정.** 도메인, 시스템 경계, 비즈니스 결과, 배포 및 데이터 제약, 팀 역량, 알려진 증거, 미지수, 의사결정 권한을 식별합니다. 이미 위임된 권한을 존중하세요. 결과를 바꿀 수 있는 누락된 사실만 요청하고, 그렇지 않으면 조건부 권고를 제공합니다.
2. **동인 순위 매기기.** 이해관계자의 결과를 아키텍처 특성으로 변환합니다. 세 부분 정의에 따라 각 후보를 테스트하고, 복합 품질을 분해하며, 소수의 우선순위를 정합니다.
3. **경계 및 데이터 매핑.** 기능적 책임, 의존성, 트랜잭션, 데이터 소유권, 정적 결합, 런타임 호출, 각 관련 경계의 특성을 식별합니다.
4. **비례 비교.** 중대한 선택의 경우, 명시된 우선순위, 비용, 위험, 증거에 대해 최소 두 가지 실행 가능한 옵션을 비교합니다. 작고 되돌릴 수 있는 변경에 대해 공식 비교를 강요하지 마세요.
5. **근거 있는 결정.** 권고 또는 상태, 적합한 이유, 수용된 비용, 가정, 재고를 유발할 증거를 명시합니다. 위임된 권한을 따르고 승인 절차를 임의로 만들지 마세요.
6. **검사 명세.** 위험에 비례하는 측정치 또는 적합성 함수를 선택합니다. 범위, 신호, 한계, 대응을 명명하세요.

## 핵심 규칙

- 권고는 컨텍스트([context and priority rules](references/rulebook.md#context-priorities): F01)에 근거하고 위임된 권한([decision, risk, and evolution rules](references/rulebook.md#decisions-risk-evolution): D03)을 존중합니다.
- 측정 가능한 이해관계자 결과에서 특성을 도출하고 순위를 매깁니다([context and priority rules](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18).
- 책임은 응집력 있게 유지하고 경계는 의존성과 결합에 대해 정직하게 유지합니다([boundary rules](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [glossary](references/glossary.md)).
- 작업에 적합한 통신 방식을 선택하고 요청, 명령, 이벤트를 구분하며 실패에 대비해 설계합니다([communication rules](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08).
- 아키텍처 스타일을 조건부 옵션으로 취급하고 비용을 비교합니다([style rules](references/rulebook.md#style-choice): S01, S16, D06; [style guide](references/style-selection.md)).
- 중대한 결정이 존재하는 이유와 변경될 조건을 기록합니다([trade-offs](references/rulebook.md#context-priorities): F02; [decision records](references/rulebook.md#decisions-risk-evolution): F03).
- 위험, 불확실성, 구현 정렬을 가시화합니다([risk and evolution rules](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13).
- 사람들이 이해할 수 있는 검사로 중요한 제약을 관리합니다([governance rules](references/rulebook.md#decisions-risk-evolution): F09, F10).
- 실제 권한과 제약 내에서 팀 선택을 보존합니다([team and communication rules](references/rulebook.md#communication-teams): S04, D16, D17, D18).
- 프로젝트에 모델 제공자가 포함된 경우에만 공급자별 지침을 적용합니다([D15 in rules.json](references/rules.json)).

## 출력 계약

반환: 컨텍스트와 미지수; 권고 및 상태; 대안 및 비용; 경계, 데이터, 통신 영향; 증거 및 검사; 재고 트리거. 선택의 중대성에 따라 세부사항을 조정하세요.

## 참고자료

작업에 대해 [rules.json](references/rules.json)에서 관련 카테고리만 로드하거나 [rulebook.md](references/rulebook.md)에서 해당 섹션만 읽으세요. 둘 다 또는 전체 패키지를 읽지 마세요. 아홉 가지 스타일은 [style-selection.md](references/style-selection.md), 출처 기반 용어는 [glossary.md](references/glossary.md), 인용된 장 위치는 [source-map.json](references/source-map.json)을 참조하세요. 합성 평가 프롬프트는 [evaluation-cases.json](references/evaluation-cases.json)에 있으며 실행되지 않았습니다. 방법과 한계는 [method-and-validation.md](references/method-and-validation.md)에 있습니다.