[G1-Sync] Manual knowledge update
This commit is contained in:
Antigravity Agent
@@ -1,125 +1,182 @@
|
||||
---
|
||||
id: wiki-2026-0508-atam-architecture-trade-offs-ana
|
||||
title: ATAM (Architecture Trade offs Analysis Method)
|
||||
title: ATAM (Architecture Trade-offs Analysis Method)
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: [P-REINFORCE-WIKI-E724CEAB]
|
||||
aliases: [atam, architecture-evaluation, architecture-review]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.95
|
||||
tags: [atam-(architecture-trade-offs-analysis-method), architecture-decision-records-(adr), iso-25010-(품질-모델), 민감도-지점-(sensitivity-points), tara-(architecture-assessment), architecture-principles]
|
||||
confidence_score: 0.9
|
||||
verification_status: applied
|
||||
tags: [architecture, evaluation, atam, sei, quality-attributes]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-05-02
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
|
||||
tech_stack:
|
||||
language: unspecified
|
||||
framework: unspecified
|
||||
language: process
|
||||
framework: sei-atam
|
||||
---
|
||||
|
||||
# [[ATAM (Architecture Trade-offs Analysis Method)]]
|
||||
# ATAM (Architecture Trade-offs Analysis Method)
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
ATAM(Architecture Trade-offs Analysis Method)은 특정 소프트웨어 아키텍처가 비즈니스 목표를 얼마나 잘 지원하는지 평가하고 아키텍처적 위험 요소를 식별하기 위해 SEI(Software Engineering Institute)에서 개발한 방법론입니다 [1, 2]. 이 방법론은 '완벽한 아키텍처는 없다'는 인식 하에, 의사결정 과정에서 불가피하게 발생하는 타협점(Compromise)을 체계적으로 찾아냅니다 [1]. 소프트웨어 아키텍처를 평가하는 데 있어 '표준(Gold Standard)'으로 간주되며, 직감이나 유행에 따른 아키텍처 선택을 방지하는 객관적인 기준을 제공합니다 [1, 3].
|
||||
## 매 한 줄
|
||||
> **"매 architecture 의 quality attribute 의 trade-off 의 reveal 한다"**. 매 ATAM 의 SEI (Software Engineering Institute, CMU) 의 1998 의 published — 매 Bass, Clements, Kazman 의 *Software Architecture in Practice* 의 codified. 매 2026 의 lightweight 의 RFC/ADR + LLM-assisted scenario generation 의 evolved 됨 — 매 core 의 still scenario-driven trade-off analysis.
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
* **시나리오 기반 분석 (Scenario-based thinking):** ATAM은 '성능'과 같이 추상적인 품질 목표를 논의하는 대신, 구체적인 시나리오를 사용하여 아키텍처를 평가합니다 [1, 2]. 예를 들어 "사용자가 10분 내에 두 배로 증가할 때 시스템이 어떻게 작동하는가?" 또는 "데이터베이스가 실패할 때 아키텍처가 어떻게 동작하는가?"와 같은 특정한 자극과 반응을 통해 아키텍처의 한계를 시험합니다 [1, 2].
|
||||
* **트레이드오프 식별 (Identification of trade-offs):** 분석 과정을 통해 여러 품질 속성 간의 상호작용과 절충점(Trade-off Points)을 명확히 드러냅니다 [1, 2]. 극단적으로 안전한 시스템(높은 암호화)을 구현하면 성능(지연 시간)을 희생해야 하거나, 가용성을 높이기 위해 일관성을 양보해야 하는 등의 상충 관계를 찾아냅니다 [1, 2].
|
||||
* **위험 및 민감도 지점 도출 (Risks and sensitivity points):** 아키텍처가 어느 부분에서 민감한지(sensitive)를 파악합니다 [1]. 이를 통해 설계자가 단순히 '유행하는 패턴의 관점'에서만 생각하는 것을 방지하고, 라이브 운영(Live operation) 중 발생할 수 있는 예상치 못한 문제들로부터 시스템을 보호합니다 [1].
|
||||
* **아키텍처 비교 및 의사결정:** ATAM은 측정 가능한 품질 기준을 바탕으로 여러 아키텍처 접근법을 비교하는 데 사용되며, 순수한 직감에 의한 결정을 체계적인 의사결정 프로세스로 전환합니다 [3, 4]. 이 과정의 핵심 산출물로는 '위험 테마 및 트레이드오프 보고서'가 생성됩니다 [5].
|
||||
* **사전 분석을 통한 위험 완화:** 시스템이 구축되기 전에 소프트웨어 시스템의 동작을 분석할 수 있는 기반을 제공합니다 [6]. 실제 구축 없이도 시스템이 이해관계자의 요구를 충족하는지 검증함으로써 실질적인 비용 절감과 위험 완화 효과를 가져옵니다 [6].
|
||||
## 매 핵심
|
||||
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
|
||||
ATAM 자체는 시스템의 트레이드오프를 밝혀내는 분석 방법론이므로, 이 방법론이 도출하는 핵심적인 제약 사항은 바로 "모든 아키텍처 결정은 곧 타협(Trade-off)"이라는 사실입니다 [1].
|
||||
* **품질 속성 간의 상충:** 성능, 보안, 가용성, 유지보수성 등 다양한 품질 속성을 동시에 완벽하게 달성하는 것은 불가능하며, 하나의 품질 속성을 최적화(예: 개발 속도 극대화)하면 필연적으로 다른 속성(예: 향후 유지보수성)이 저하되는 반대 급부가 발생함을 인정해야 합니다 [1, 2].
|
||||
* **패턴 맹신에 대한 경고:** 특정 아키텍처 패턴이 현대적이고 유행한다는 이유만으로 선택해서는 안 되며, 구체적인 시나리오를 바탕으로 철저히 한계를 시험하고 약점을 파악하는 분석 과정을 반드시 거쳐야 한다는 제약을 부여합니다 [1].
|
||||
### 매 9 phases (classical ATAM)
|
||||
1. Present ATAM (method intro).
|
||||
2. Present business drivers.
|
||||
3. Present architecture.
|
||||
4. Identify architectural approaches.
|
||||
5. Generate quality attribute utility tree.
|
||||
6. Analyze approaches against scenarios.
|
||||
7. Brainstorm + prioritize scenarios (stakeholders).
|
||||
8. Re-analyze.
|
||||
9. Present results.
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
### Related Concepts
|
||||
### 매 outputs
|
||||
- **Utility tree**: quality goals → attributes → scenarios (H/M/L priority + difficulty).
|
||||
- **Risks**: 매 architecture decision 의 negative consequence.
|
||||
- **Non-risks**: 매 sound decision 의 confirmation.
|
||||
- **Sensitivity points**: 매 single decision 의 single attribute 의 strongly affect.
|
||||
- **Trade-off points**: 매 single decision 의 multiple attributes 의 differently affect.
|
||||
|
||||
#### [관계 유형 A: 아키텍처 평가 및 기록]
|
||||
- [[Architecture Decision Records (ADR)]]
|
||||
- 연결 이유: ATAM 분석을 통해 식별된 트레이드오프와 아키텍처 결정 사항, 그 근거 및 대안들을 문서화하여 기록하는 도구입니다 [5, 7].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: ATAM에서 도출된 평가 결과가 어떻게 시스템의 역사적 자산으로 보존되고, 새로운 팀원이나 이해관계자에게 아키텍처의 의도를 명확히 전달하는지 이해할 수 있습니다 [5, 8].
|
||||
|
||||
- [[ISO 25010 (품질 모델)]]
|
||||
- 연결 이유: ATAM에서 구체적인 시나리오로 평가하고자 하는 성능, 확장성, 호환성 등 아키텍처의 비기능적 품질 요구사항에 대한 표준화된 기준을 제공합니다 [9, 10].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 아키텍처 트레이드오프 분석 시, 시스템 설계자가 어떤 구체적인 품질 특성들을 서로 비교하고 타협해야 하는지 객관적인 평가 척도를 파악할 수 있습니다 [5, 10].
|
||||
|
||||
#### [관계 유형 B: 위험 관리 메커니즘]
|
||||
- [[민감도 지점 (Sensitivity Points)]]
|
||||
- 연결 이유: ATAM 평가를 통해 도출되는 핵심 결과물 중 하나로, 아키텍처가 특정 조건이나 시나리오에 얼마나 취약하게 반응하는지를 나타내는 지점입니다 [1].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 시스템이 라이브 운영 시 직면할 수 있는 병목 현상이나 장애 위험을 사전에 인지하여 시스템의 신뢰성을 높이는 방안을 학습할 수 있습니다 [1].
|
||||
|
||||
### Deeper Research Questions
|
||||
- ATAM 평가 과정에서 추상적인 품질 목표를 대체하는 구체적인 '자극과 반응 시나리오'는 주로 어떤 이해관계자들의 합의를 거쳐 도출되는가?
|
||||
- TARA 등 다른 아키텍처 평가 프레임워크와 비교했을 때, ATAM이 트레이드오프를 식별하는 방식은 실무적으로 어떤 차별점과 한계를 지니는가?
|
||||
- 애자일(Agile) 환경처럼 빠른 개발과 반복이 중요한 상황에서, ATAM과 같은 철저한 시나리오 기반의 아키텍처 검증 과정을 어떻게 병목 없이 적용할 수 있는가?
|
||||
- 마이크로서비스(Microservices)와 이벤트 기반(Event-Driven) 아키텍처를 ATAM으로 비교 평가할 때, 분산 시스템 특유의 복잡성은 어떤 구체적인 트레이드오프 지점(Trade-off Points)으로 나타나는가?
|
||||
- ATAM의 핵심 산출물인 '위험 테마 및 트레이드오프 보고서'는 향후 실제 코드 구현이나 프로토타이핑(Prototyping) 단계의 전략으로 어떻게 구체화되는가?
|
||||
|
||||
### Practical Application Contexts
|
||||
- **Implementation:** 데이터베이스 실패나 10분 내 사용자 두 배 증가와 같은 ATAM의 구체적인 테스트 시나리오를 바탕으로, 코드 레벨에서 이를 견딜 수 있는 장애 조치(예: 서킷 브레이커)나 확장 로직을 직접 구현합니다 [1].
|
||||
- **System Design:** 단순히 현재 유행하는 패턴(예: 무조건적인 MSA 도입)을 따르는 대신, ATAM의 시나리오 기반 평가와 의사결정 매트릭스를 활용하여 프로젝트 요구사항에 가장 적절한 아키텍처를 전략적으로 선택합니다 [2, 3].
|
||||
- **Operation / Maintenance:** ATAM을 통해 밝혀진 아키텍처의 민감도 지점(Sensitivity Points)을 기반으로, 시스템의 취약한 영역에 대한 모니터링을 강화하고 운영 중 발생할 수 있는 불쾌한 사고(unpleasant surprises)에 선제적으로 대비합니다 [1].
|
||||
- **Learning Path:** 개발자가 코드를 넘어 시스템의 거시적인 관점을 가지기 위해 필수적인 단계로, 단순한 패턴의 암기가 아닌 요구사항 간의 충돌을 인지하고 타협하는 아키텍처적 사고 능력을 배양합니다 [1].
|
||||
- **My Project Relevance:** 초기 설계 단계에서 아키텍처 결정이 향후 변경하기 매우 비용이 많이 든다는 점을 고려할 때, 시스템 구축 전에 설계의 한계와 위험성을 미리 검증하여 막대한 기술 부채를 방지하는 데 활용할 수 있습니다 [11, 12].
|
||||
|
||||
### Adjacent Topics
|
||||
- [[TARA (Architecture Assessment)]]
|
||||
- 확장 방향: ATAM과 더불어 산업계에서 소프트웨어 아키텍처를 평가하고 검토하는 데 사용되는 또 다른 평가 기법으로, 아키텍처 평가 방법론의 지식을 더욱 확장할 수 있습니다 [13].
|
||||
- [[소프트웨어 아키텍처 침식 (Software Architecture Erosion)]]
|
||||
- 확장 방향: ATAM 등을 통해 초기 설계 당시 의도되었던 아키텍처가 시스템의 지속적인 진화와 유지보수 과정에서 어떻게 변질되고 붕괴되는지, 그리고 이를 어떻게 막을 것인지에 대한 운영적 관점의 연구로 나아갈 수 있습니다 [14].
|
||||
|
||||
---
|
||||
*Last updated: 2026-05-02*
|
||||
|
||||
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
|
||||
|
||||
**언제 이 지식을 쓰는가:**
|
||||
- *(TODO)*
|
||||
|
||||
**언제 쓰면 안 되는가:**
|
||||
- *(TODO)*
|
||||
|
||||
## 🧪 검증 상태 (Validation)
|
||||
|
||||
- **정보 상태:** needs_review
|
||||
- **출처 신뢰도:** A
|
||||
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
|
||||
|
||||
## 🧬 중복 검사 (Duplicate Check)
|
||||
|
||||
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
|
||||
- **처리 방식:** UPDATE (자동 정규화)
|
||||
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
|
||||
|
||||
## 🕓 변경 이력 (Changelog)
|
||||
|
||||
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|
||||
|------|-----------|-----------|--------|
|
||||
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
|
||||
|
||||
## 💻 코드 패턴 (Code Patterns)
|
||||
|
||||
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
|
||||
|
||||
```text
|
||||
# TODO
|
||||
### 매 scenario template
|
||||
```
|
||||
Stimulus (event) — Source (actor) — Environment (state) →
|
||||
Artifact (component) → Response (system action) → Measure (latency, %, etc.)
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준 (Decision Criteria)
|
||||
### 매 응용
|
||||
1. Pre-build architecture review.
|
||||
2. Major refactor 의 GO/NO-GO.
|
||||
3. Vendor selection — 매 candidate 의 same scenarios 의 score.
|
||||
4. Tech radar 의 input.
|
||||
|
||||
**선택 A를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
## 💻 패턴
|
||||
|
||||
**선택 B를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
### Utility tree (Markdown)
|
||||
```markdown
|
||||
# Utility Tree — Order Service v3
|
||||
|
||||
**기본값:**
|
||||
> *(TODO)*
|
||||
## Performance
|
||||
- (H, H) p95 checkout latency < 300ms at 10k RPS
|
||||
- (H, M) Cold start < 500ms (serverless)
|
||||
- (M, L) Background job throughput > 1k/s
|
||||
|
||||
## ❌ 안티패턴 (Anti-Patterns)
|
||||
## Availability
|
||||
- (H, H) 99.99% monthly SLO for /checkout
|
||||
- (H, M) Graceful DB failover < 30s
|
||||
- (M, M) Region evacuation < 5min
|
||||
|
||||
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
## Modifiability
|
||||
- (H, M) New payment method added in < 5 dev-days
|
||||
- (M, L) Tenant-specific pricing rules without redeploy
|
||||
|
||||
## Security
|
||||
- (H, H) PCI-DSS compliance for card data path
|
||||
- (M, M) PII encryption at rest
|
||||
|
||||
(H/M/L = Importance, Difficulty)
|
||||
```
|
||||
|
||||
### Scenario (concrete)
|
||||
```yaml
|
||||
id: PERF-01
|
||||
quality_attribute: performance
|
||||
priority: H
|
||||
difficulty: H
|
||||
stimulus: "10,000 concurrent checkout submissions"
|
||||
source: "authenticated mobile clients"
|
||||
environment: "normal operations, peak hour"
|
||||
artifact: "checkout-api + payment-gateway"
|
||||
response: "process to confirmed order"
|
||||
measure: "p95 < 300ms, p99 < 800ms, error rate < 0.1%"
|
||||
analysis:
|
||||
approach: "Read-through Redis cache + async write to Kafka"
|
||||
sensitivity: ["Redis cluster size", "Kafka partition count"]
|
||||
tradeoff: "Cache adds read latency variance vs DB-direct correctness"
|
||||
risk: "Cache stampede on Redis failover"
|
||||
mitigations: ["request coalescing", "stale-while-revalidate"]
|
||||
```
|
||||
|
||||
### Risk / Non-risk / Sensitivity / Trade-off ledger
|
||||
```markdown
|
||||
| ID | Type | Decision | Affects | Status |
|
||||
|----|------|----------|---------|--------|
|
||||
| R-01 | Risk | Sync DB write in checkout | Avail, Perf | Open — needs async branch |
|
||||
| R-02 | Sensitivity | Redis TTL = 60s | Performance | Confirmed — measured |
|
||||
| R-03 | Tradeoff | Multi-region active-active | Avail+ / Cost-, Consist- | Accepted in ADR-014 |
|
||||
| N-01 | Non-risk | JWT for auth | Security | OK — standard practice |
|
||||
```
|
||||
|
||||
### Lightweight ATAM (modern, 2-day workshop)
|
||||
```markdown
|
||||
Day 1 AM: Business drivers + architecture walkthrough (2h)
|
||||
Day 1 PM: Utility tree co-construction (3h)
|
||||
Day 2 AM: Scenario analysis — top 5 (4h)
|
||||
Day 2 PM: Risks/tradeoffs ledger + ADR drafts (3h)
|
||||
Output: 1-page exec summary + per-scenario deep dives
|
||||
```
|
||||
|
||||
### Tooling — Structurizr + ADR + LLM
|
||||
```bash
|
||||
# 1. Architecture in Structurizr DSL
|
||||
# 2. ADRs in /docs/adr/*.md (adr-tools)
|
||||
adr new "Use Redis cache for checkout reads"
|
||||
|
||||
# 3. LLM-assisted scenario brainstorm
|
||||
claude --prompt "Given utility tree and arch, propose 10 stress scenarios"
|
||||
|
||||
# 4. CI gate — utility-tree.yml diff = ADR required
|
||||
```
|
||||
|
||||
### CBAM extension (cost-benefit)
|
||||
```python
|
||||
# Cost-Benefit Analysis Method (Kazman, Asundi, Klein 2002)
|
||||
def score(scenario):
|
||||
benefit = scenario.utility * scenario.weight
|
||||
cost = scenario.implementation_cost
|
||||
return benefit / cost # ROI for prioritization
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Method |
|
||||
|---|---|
|
||||
| Greenfield, high-stakes | Full ATAM (5-day) |
|
||||
| Iteration / sprint review | Lightweight ATAM (1-2 day) |
|
||||
| Single decision | ADR with trade-off section |
|
||||
| Cost-aware prioritization | CBAM |
|
||||
| Solo / startup | RFC + scenario list (informal) |
|
||||
| Continuous | Fitness functions + ADR |
|
||||
|
||||
**기본값**: ADR-per-decision + lightweight ATAM 의 quarterly.
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[Software Architecture]] · [[Quality Attributes]]
|
||||
- 변형: [[SAAM]] · [[ARID]] · [[CBAM]] · [[Lightweight-Architecture-Review]]
|
||||
- 응용: [[ADR]] · [[RFC]] · [[Architecture_Refactor]]
|
||||
- Adjacent: [[Architecture Evaluation (아키텍처 평가)]] · [[Architecture Review (아키텍처 및 설계 리뷰)]] · [[Architectural-Constraint-Enforcement]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: 매 utility tree 의 first-draft generation, 매 scenario 의 stress-test brainstorm, 매 risk ledger 의 categorization.
|
||||
**언제 X**: 매 final risk acceptance — 매 stakeholder consensus 의 필수.
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **Theatre review**: 매 architect-only attendance — 매 stakeholder buy-in 의 X.
|
||||
- **Scenario without measure**: 매 "fast" / "scalable" — 매 unfalsifiable.
|
||||
- **No follow-up**: 매 risks 의 logged 의 forgotten — 매 ADR 의 link 의 필수.
|
||||
- **One-time**: 매 architecture 의 evolves — 매 evaluation 의 also.
|
||||
- **Skip business drivers**: 매 quality attributes 의 prioritization 의 wrong.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (Bass, Clements, Kazman — *Software Architecture in Practice* 4th ed; SEI tech reports CMU/SEI-2000-TR-004).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — utility tree + scenarios + risk ledger + lightweight ATAM |
|
||||
|
||||
Reference in New Issue
Block a user