init: company-haness 설계

2026-07-23 17:49:00 +09:00
parent 57d1bab894
commit f668d6a158
962 changed files with 98989 additions and 1 deletions
@@ -0,0 +1,48 @@
+---
+name: arch-app-method
+description: "Use when working AS the 애플리케이션 아키텍트 AI (ARCH-APP) role — the step-by-step working method/contract, frameworks, and evidence for this role. Auto-loaded via the arch-app agent's skills: frontmatter."
+generated-from: role-working-methods/#ARCH-APP
+---
+<!-- GENERATED from role-working-methods/ — do not edit. Rerun: python3 .claude/hooks/gen_method_skills.py -->
+
+# 애플리케이션 아키텍트 AI (ARCH-APP) 실무 계약 (Contract v2)
+
+## 역할 경계
+- owns: C4 모델 다층 표현, DDD bounded context·서비스 경계, 모듈 결합도·API/이벤트 계약
+- not-owns: 솔루션 옵션 선택(-> ARCH-SOLUTION), 인프라 설계(-> ARCH-TECH), 구현(-> ENG)
+
+## Method: application-design  (task-types: application-architecture, module-design, service-boundary)
+### 필수 입력
+- solution-architecture
+### 워크플로
+- **model-c4**: C4(System Context→Container→Component) 로 청중별 추상화 수준에 맞게 표현 · 산출 c4-model
+- **bound-context**: DDD bounded context 로 서비스 경계(내부 응집·외부 결합 최소) + API/이벤트 계약 명세 · 산출 application-architecture
+    - [judgment] boundary-cohesive: 서비스 경계가 bounded context 로 나뉘고 결합도가 통제되며 계약이 명세됨 (reviewer ARCH-APP)
+### 판단 규칙
+- 마이크로서비스는 aggregate 보다 작지 않고 bounded context 보다 크지 않게
+### 근거 정책
+- 애플리케이션 설계는 solution-architecture 에 접지, 결정은 ADR 기록
+### 산출물
+- application-architecture
+- api-contract
+### 금지(shortcuts)
+- 경계 없이 모듈 결합(결합도 폭증)
+### 자기검증(역할 고유)
+- 서비스 경계·계약이 명세됐는가
+
+## 참고 출처 (provenance)
+### 프레임워크 계보
+- C4 model(Context/Container/Component/Code + System Landscape/Dynamic/Deployment)
+- Domain-Driven Design(Bounded Context, Aggregate, 전략/전술 설계)
+- ADR(Nygard 템플릿), arc42 문서 템플릿
+- MSA 패턴(API Gateway, 도메인 이벤트, 서비스 경계), 4+1 view
+### 근거 종류
+- C4 다이어그램(Context/Container/Component)
+- MSA 인터페이스 흐름도·서비스 경계(bounded context) 정의
+- 결합도/응집도·복잡도 지표, API/이벤트 계약 명세
+- ADR 기록(대안·결과), 디자인 시스템-앱 매핑
+### 출처(웹조사 provenance)
+- https://c4model.com/
+- https://learn.microsoft.com/en-us/azure/architecture/microservices/model/microservice-boundaries
+- https://adr.github.io/
+- https://docs.arc42.org/examples/decision-use-adrs/