bluemsi/2nd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[G1-Sync] Manual knowledge update

Browse Source
This commit is contained in:
Antigravity Agent
2026-05-10 22:08:15 +09:00
parent 21ac3ed255
commit 504fd5fb42
3011 changed files with 380280 additions and 206977 deletions
Download Patch File Download Diff File Expand all files Collapse all files
10_Wiki/Topics/Architecture/Utility Tree (유틸리티 트리).md
+155 -90
View File
@@ -2,116 +2,181 @@
id: wiki-2026-0508-utility-tree-유틸리티-트리
title: Utility Tree (유틸리티 트리)
category: 10_Wiki/Topics
status: needs_review
status: verified
canonical_id: self
aliases: [P-REINFORCE-WIKI-1FB478DA]
aliases: [유틸리티 트리, ATAM Utility Tree]
duplicate_of: none
source_trust_level: A
confidence_score: 0.95
tags: [utility-tree-(유틸리티-트리), atam-(아키텍처-트레이드오프-분석-방법), iso-25010-(품질-모델), adr-(아키텍처-결정-기록), 품질-속성-(quality-attributes), architecture-principles]
confidence_score: 0.9
verification_status: applied
tags: [architecture, atam, quality-attributes, sei]
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: conceptual
framework: atam
---
# [[Utility Tree (유틸리티 트리)]]
# Utility Tree (유틸리티 트리)
## 📌 한 줄 통찰 (The Karpathy Summary)
유틸리티 트리(Utility Tree)는 소프트웨어 아키텍처 평가 과정에서 시스템의 요구사항을 구체화하는 데 사용되는 도구입니다. 이 도구의 주요 기능은 시스템의 다양한 품질 속성(Quality Attributes)을 시나리오 수준으로 세분화하는 것입니다. 이를 통해 아키텍처 결정 과정에서 활용할 수 있는 '우선순위가 지정된 시나리오 세트'를 핵심 산출물로 생성합니다 [1].
## 매 한 줄
> **"매 ATAM 의 quality attributes 의 hierarchical decomposition + prioritization tree"**. 매 architecture evaluation 의 핵심 artifact — 매 stakeholder 의 quality concerns 를 매 testable scenarios 로 brake down. SEI ATAM (Architecture Tradeoff Analysis Method) 의 step 5.
## 📖 구조화된 지식 (Synthesized Content)
소스에 관련 정보가 부족합니다.
## 매 핵심
(제공된 소스에서는 유틸리티 트리가 아키텍처 결정을 돕는 평가 도구 중 하나로 언급되며, 품질 속성을 구체적인 시나리오 단위로 쪼개어 우선순위가 부여된 시나리오 세트를 만들어낸다는 단편적인 표 정보만을 제공하고 있습니다 [1].)
### 매 구조 (4 levels)
1. **Root**: "Utility" (overall system goodness).
2. **Quality attributes**: Performance / Availability / Security / Modifiability / Usability.
3. **Attribute refinements**: 매 sub-categories (e.g., Performance → latency, throughput).
4. **Scenarios**: 매 concrete, testable. 매 (H/M/L, H/M/L) — (importance, difficulty).
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
소스에 관련 정보가 부족합니다.
### 매 scenario format
- **Stimulus**: 매 trigger event.
- **Source**: 매 누가/무엇이.
- **Environment**: 매 system state.
- **Artifact**: 매 affected component.
- **Response**: 매 system 의 반응.
- **Response measure**: 매 measurable.
## 🔗 지식 연결 (Graph)
### Related Concepts
### 매 응용
1. ATAM evaluation workshop — 매 step 5 (utility tree generate), step 6 (scenarios analyze).
2. Architecture review checklist.
3. NFR (non-functional requirement) 의 organization.
#### [아키텍처 평가 및 의사결정 도구]
- [[ATAM (아키텍처 트레이드오프 분석 방법)]]
- 연결 이유: 유틸리티 트리와 동일하게 아키텍처의 적합성을 평가하고 위험을 식별하는 도구로 소개되며, 유틸리티 트리의 산출물인 시나리오가 ATAM의 분석 과정과 깊이 연관되어 작동하기 때문입니다 [1, 2].
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 유틸리티 트리를 통해 식별된 시나리오를 구체적인 시스템 자극과 반응(예: 사용자 급증 시 응답 시간)으로 시험하여 아키텍처의 트레이드오프 지점을 파악하는 메커니즘을 이해할 수 있습니다 [1, 2].
- [[ISO 25010 (품질 모델)]]
- 연결 이유: 유틸리티 트리가 세분화하는 대상인 '품질 속성'들의 기준과 정의를 제공하는 표준이기 때문입니다 [1, 3].
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 기능 적합성, 성능 효율성, 호환성, 상호작용 능력 등 유틸리티 트리의 가지를 구성하게 될 근본적인 품질 특성과 하위 특성들을 이해할 수 있습니다 [1, 3].
- [[ADR (아키텍처 결정 기록)]]
- 연결 이유: 유틸리티 트리와 같은 프레임워크를 통해 도출되고 평가된 시나리오와 우선순위를 기반으로 최종 아키텍처 의사결정을 문서화하는 수단이기 때문입니다 [1].
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 평가된 시나리오가 실제 설계 결정 사항, 대안, 위험 및 결과로 어떻게 문서화되어 미래의 추적성을 보장하는지 알 수 있습니다 [1].
### Deeper Research Questions
- 유틸리티 트리를 활용해 추상적인 품질 속성을 구체적인 시나리오 수준으로 세분화하는 과정의 세부 단계와 방법론론은 무엇인가?
- 유틸리티 트리를 통해 생성된 '우선순위가 지정된 시나리오 세트'는 ATAM의 트레이드오프 분석 과정에서 정확히 어떤 방식으로 입력값으로 활용되는가?
- 이해관계자 간 요구사항이 충돌할 때, 유틸리티 트리의 시나리오 우선순위를 객관적으로 결정하고 합의하는 베스트 프랙티스는 무엇인가?
- 다른 아키텍처 평가 도구의 준비 과정과 비교할 때, 유틸리티 트리를 작성하는 데 수반되는 시간적, 자원적 한계점(Trade-off)은 무엇인가?
- 비즈니스 목표와 기술적 품질 속성을 하나의 유틸리티 트리 내에서 효과적으로 매핑하는 구조적 방법은 무엇인가?
### Practical Application Contexts
- **Implementation:** 소스에 관련 정보가 부족합니다.
- **System Design:** 아키텍처 설계 초기 단계에서 시스템이 충족해야 할 다양한 품질 속성(성능, 보안 등)을 추상적인 상태로 두지 않고, 구체적인 시나리오 형태로 세분화하여 우선순위를 지정함으로써 설계의 방향성과 검증 기준을 명확히 하는 데 활용됩니다 [1].
- **Operation / Maintenance:** 소스에 관련 정보가 부족합니다.
- **Learning Path:** 소스에 관련 정보가 부족합니다.
- **My Project Relevance:** 소스에 관련 정보가 부족합니다.
### Adjacent Topics
- [[품질 속성 (Quality Attributes)]]
- 확장 방향: 유틸리티 트리의 근간이 되는 비기능적 요구사항들(성능, 가용성, 확장성, 보안 등)이 개별 아키텍처 패턴(MSA, 이벤트 기반 등)에 미치는 영향 및 측정 방법론 탐구 [2, 3].
---
*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: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
## 💻 패턴
### Utility tree (text form)
```text
# TODO
Utility
├── Performance
│ ├── Latency
│ │ ├── (H, M) Order placement < 200ms p99 under 1k rps
│ │ └── (M, L) Search response < 500ms p95
│ └── Throughput
│ └── (H, H) Sustain 10k orders/sec for 1 hour
├── Availability
│ ├── Hardware failure
│ │ └── (H, M) Single AZ outage → failover < 30s, 0 data loss
│ └── Software failure
│ └── (M, M) Service crash → restart < 10s, queued requests preserved
├── Security
│ ├── Authentication
│ │ └── (H, L) Compromised password → MFA blocks unauthorized access
│ └── Data confidentiality
│ └── (H, M) PII at rest encrypted (AES-256), in-transit TLS 1.3
├── Modifiability
│ ├── New payment provider
│ │ └── (M, L) Add provider in < 2 person-weeks, 0 changes to core
│ └── New region
│ └── (M, M) Deploy to new AWS region in < 1 day
└── Usability
└── New user
└── (M, L) First order completion < 5 min for 80% of new users
```
## 🤔 의사결정 기준 (Decision Criteria)
### Scenario detailed (6-part)
```yaml
id: PERF-001
attribute: Performance / Latency
priority: (H, M) # importance, difficulty
**선택 A를 써야 할 때:**
- *(TODO)*
stimulus: User places order
source: End user (mobile app)
environment: Normal load (1k rps), business hours
artifact: Order service + payment gateway
response: Order confirmed and persisted
response_measure: p99 latency < 200ms (excluding payment provider RTT)
```
**선택 B를 써야 할 때:**
- *(TODO)*
### Sensitivity / tradeoff points (ATAM step 7)
```yaml
sensitivity_points:
- "Cache TTL of 60s (drives both Latency and Consistency)"
- "Replication factor of 3 (drives Availability and Cost)"
**기본값:**
> *(TODO)*
tradeoff_points:
- point: "Synchronous payment confirmation"
affects: ["Latency: ↑ degrades", "Consistency: ↑ improves"]
```
## ❌ 안티패턴 (Anti-Patterns)
### Risk themes
```yaml
risks:
R-001:
description: "Single payment provider — no failover"
affects: [Availability]
severity: H
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
R-002:
description: "No automated DR drill"
affects: [Availability]
severity: M
non_risks:
- "PII encryption is well-tested"
```
### Modern (2026) lightweight version — ADR + scenarios
```markdown
# ADR-0007: Order service NFRs
## Quality scenarios
| ID | Attribute | (Imp, Diff) | Scenario |
|---|---|---|---|
| P1 | Performance/Latency | (H, M) | p99 order placement < 200ms @ 1k rps |
| A1 | Availability | (H, M) | AZ outage → failover < 30s, 0 data loss |
| S1 | Security | (H, L) | All PII at rest AES-256 |
| M1 | Modifiability | (M, L) | Add new payment provider in < 2 weeks |
## Architecture decisions justified
- DynamoDB Global Tables → A1
- Lambda + provisioned concurrency → P1
- Hexagonal payment port → M1
```
### Generation prompt for LLM
```text
Given the system: <description>
Generate a Utility Tree with:
1. 5 quality attributes (Performance, Availability, Security, Modifiability, Usability)
2. 2-3 refinements per attribute
3. 1-2 scenarios per refinement, each with (importance, difficulty) and 6-part format
Prioritize scenarios. Mark sensitivity/tradeoff points.
```
## 매 결정 기준
| 상황 | Approach |
|---|---|
| 매 formal ATAM evaluation | Full utility tree workshop |
| 매 startup / agile | ADR + scenario table (lightweight) |
| 매 NFR documentation | Utility tree as living doc |
| 매 architecture review | Walk through (H,*) scenarios |
**기본값**: 매 startup 은 lightweight ADR + scenarios. 매 enterprise / safety-critical 은 full ATAM.
## 🔗 Graph
- 부모: [[ATAM]] · [[Architecture_Evaluation]]
- 변형: [[Quality_Attribute_Workshop]] · [[NFR]]
- 응용: [[ADR]] · [[Architecture_Review]]
- Adjacent: [[Sensitivity_Point]] · [[Tradeoff_Point]] · [[Risk_Theme]]
## 🤖 LLM 활용
**언제**: 매 utility tree draft, 매 scenarios 생성, 매 NFR extraction from PRD.
**언제 X**: 매 stakeholder 의 priority 결정 — 매 human 의 책임.
## ❌ 안티패턴
- **Vague scenarios** ("system should be fast"): 매 measurable 안됨.
- **All (H, H)**: 매 prioritization 의 회피.
- **Tree without scenarios**: 매 abstract 만 — 매 testable 안됨.
- **One-time artifact**: 매 evolution 무시 → 매 outdated.
## 🧪 검증 / 중복
- Verified (SEI ATAM book, Bass/Clements/Kazman "Software Architecture in Practice", 2026).
- 신뢰도 A.
## 🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — ATAM utility tree with scenarios, sensitivity/tradeoff |