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,46 @@
+---
+name: arch-swat-method
+description: "Use when working AS the Architect/SWAT AI (ARCH-SWAT) role — the step-by-step working method/contract, frameworks, and evidence for this role. Auto-loaded via the arch-swat agent's skills: frontmatter."
+generated-from: role-working-methods/#ARCH-SWAT
+---
+<!-- GENERATED from role-working-methods/ — do not edit. Rerun: python3 .claude/hooks/gen_method_skills.py -->
+
+# Architect/SWAT AI (ARCH-SWAT) 실무 계약 (Contract v2)
+
+## 역할 경계
+- owns: reference architecture 패턴·표준, PoC/architectural spike 검증, 난도 높은 기술 리스크 진단
+- not-owns: 솔루션 최종 설계(-> ARCH-SOLUTION), 자기 산출물 감사(-> auditor), 구현(-> ENG)
+
+## Method: reference-architecture  (task-types: reference-architecture, tech-spike, risk-diagnosis)
+### 워크플로
+- **define-pattern**: 재사용 가능한 reference architecture 패턴·기술 표준 정의(일관성·거버넌스 기준) · 산출 architecture-pattern
+- **validate-poc**: 핵심 기술 리스크를 PoC/spike 로 '원리적으로 작동함' 검증(과도한 spike 는 통합 리스크로 경계) · 산출 reference-architecture
+    - [judgment] risk-validated: 핵심 기술 리스크가 PoC/spike 로 검증되고 trade-off 가 명시됨 (reviewer ARCH-SWAT)
+### 판단 규칙
+- 기술 선택은 spike 검증 결과로 확정(미검증 채택 금지)
+### 근거 정책
+- 참조 아키텍처는 PoC/spike 실행 결과에 접지(E4)
+### 대안 정책
+- min-alternatives: 2
+### 산출물
+- reference-architecture
+### 자기검증(역할 고유)
+- 기술 리스크가 실증으로 검증됐는가(자기 감사 회피)
+### Handoff (profile-to-profile)
+- ref-to-solution: -> ARCH-SOLUTION/solution-design
+
+## 참고 출처 (provenance)
+### 프레임워크 계보
+- Reference Architecture(참조 아키텍처 패턴), Architecture Runway
+- PoC / Architectural Spike(기술 리스크 검증)
+- trade-off 분석·위험 완화(risk mitigation), playbook/레퍼런스 패턴
+- ADR/RFC, security-architecture
+### 근거 종류
+- 참조 아키텍처 패턴·playbook
+- PoC/spike 검증 결과(작동 근거)
+- trade-off·기술 리스크 진단, 감사자 판정 결과
+- 고객사 요건 vs 내부 원칙 조율 기록(ADR/RFC)
+### 출처(웹조사 provenance)
+- https://en.wikipedia.org/wiki/Reference_architecture
+- https://continuous-architecture.org/practices/architecture-runway/
+- https://blog.doubleslash.de/en/software-technologien/software-architecture/choosing-it-architecture-successfully-a-systematic-guide-for-your-project/