feat: Wiki 지식 자산 업데이트 - UX Scenarios, Frontend, Game Design, Topics 추가 [2026-05-08]

This commit is contained in:
2026-05-08 19:52:07 +09:00
parent 9dd3d40662
commit 5ba5a55c78
3984 changed files with 334557 additions and 28839 deletions
@@ -1,17 +1,29 @@
---
id: P-REINFORCE-WIKI-72D5C126
category: Unified
id: wiki-2026-0508-architecture-anti-patterns
title: Architecture Anti patterns
category: 10_Wiki/Topics
status: needs_review
canonical_id: self
aliases: [P-REINFORCE-WIKI-72D5C126]
duplicate_of: none
source_trust_level: A
confidence_score: 0.95
tags: ['architecture-anti-patterns', 'circuit-breaker-pattern', 'architecture-decision-record-(adr)', 'anaemic-domain-model', 'software-architecture-erosion', 'architecture-principles']
tags: [architecture-anti-patterns, circuit-breaker-pattern, architecture-decision-record-(adr), anaemic-domain-model, software-architecture-erosion, architecture-principles]
raw_sources: []
last_reinforced: 2026-05-02
github_commit: pending
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
tech_stack:
language: unspecified
framework: unspecified
---
# [[Architecture Anti-patterns]]
## 📌 Brief Summary
## 📌 한 줄 통찰 (The Karpathy Summary)
아키텍처 안티패턴(Architecture Anti-patterns)은 소프트웨어 시스템 설계 및 진화 과정에서 발생할 수 있는 비효율적이거나 잘못된 아키텍처 결정 및 관행을 의미합니다 [1, 2]. 분산 시스템에서의 잘못된 타임아웃 설정, 의사결정의 지연(분석 마비), 또는 문서화되지 않은 결정 등이 대표적인 사례입니다 [1, 2]. 이러한 안티패턴을 인지하고 해결하는 것은 시스템의 성능 저하와 커뮤니케이션 단절을 막는 데 필수적이지만, 하나의 안티패턴을 해결하는 과정이 연쇄적으로 또 다른 안티패턴을 유발할 수도 있으므로 주의가 필요합니다 [2].
## 📖 Core Content
## 📖 구조화된 지식 (Synthesized Content)
소스 데이터를 기반으로 확인된 주요 아키텍처 안티패턴은 다음과 같습니다.
- **타임아웃 안티패턴 (Timeout AntiPattern):** 분산 시스템에서 타임아웃 값을 설정할 때 발생하는 문제를 설명합니다 [1]. 타임아웃을 너무 짧게 설정하면 정상적인 요청도 조기에 실패 처리되어 복잡한 우회 방법이 필요해지며, 너무 길게 설정하면 오류 응답이 늦어져 사용자 경험이 심각하게 저하됩니다 [1].
@@ -19,14 +31,13 @@ last_reinforced: 2026-05-02
- **문서화되지 않은 결정 (Forgotten/Undocumented Decisions):** 아키텍처 결정이 이메일과 같은 휘발성 매체를 통해 소통되거나 제대로 기록되지 않아 잊혀지는 현상입니다 [2]. 이는 명확한 결론 없이 동일한 논의가 반복되는 결과를 초래합니다 [2].
- **빈약한 도메인 모델 (Anaemic Model):** 전통적으로는 안티패턴으로 간주되지만, 마이크로서비스 아키텍처와 같이 단일 도메인의 기능만 포함하는 매우 작은 서비스에서는 이러한 트랜잭션 스크립트 기반의 단순한 모델이 오히려 효율적일 수 있다는 논의도 존재합니다 [3].
## Trade-offs & Caveats
## 모순 및 업데이트 (Contradictions & Updates)
- **안티패턴 해결의 연쇄 작용:** 아키텍처 안티패턴은 종종 점진적인 시퀀스를 따르기 때문에, 하나의 안티패턴을 해결하기 위한 조치가 또 다른 안티패턴의 출현으로 이어질 수 있는 제약 및 부작용을 동반합니다 [2].
- **타임아웃 설정의 딜레마:** 타임아웃 안티패턴에서 짧은 타임아웃(정상 요청의 실패 위험)과 긴 타임아웃(느린 에러 응답) 사이의 타협점(Trade-off)을 찾는 것은 매우 어렵습니다 [1]. 이를 최적화하기 위해 서킷 브레이커(Circuit Breaker) 패턴을 도입할 수 있으나, 이는 서비스 상태를 실시간으로 모니터링해야 하는 시스템적 복잡성을 추가로 요구합니다 [1].
- **문서화 오버헤드:** 문서화되지 않은 결정 안티패턴을 피하기 위해서는 기술적 및 비즈니스적(비용, 시장 출시 시간 등) 타당성을 명시한 아키텍처 결정 기록(ADR)을 위키와 같은 중앙 저장소에 엄격하게 관리해야 하는 관리적 반대 급부가 따릅니다 [2].
- **결정 시점의 위험성:** 분석 마비를 피하기 위해 '마지막 책임 순간'까지 결정을 보류하는 것은 유연성을 유지하는 방법이지만, 시기를 잘못 조율하면 오히려 개발 진행을 방해하는 치명적인 병목이 될 수 있습니다 [2].
## 🔗 Knowledge Connections
## 🔗 지식 연결 (Graph)
### Related Concepts
#### [아키텍처/기반 기술]
@@ -65,4 +76,53 @@ last_reinforced: 2026-05-02
- 확장 방향: 이벤트 기반 아키텍처나 분산 시스템 설계 시, 타임아웃 문제나 데이터 손실과 같이 네트워크가 항상 신뢰할 수 있다는 오해(분산 컴퓨팅의 오류)에 대한 탐구로 이어질 수 있습니다 [7, 8].
---
*Last updated: 2026-05-02*
*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
```
## 🤔 의사결정 기준 (Decision Criteria)
**선택 A를 써야 할 때:**
- *(TODO)*
**선택 B를 써야 할 때:**
- *(TODO)*
**기본값:**
> *(TODO)*
## ❌ 안티패턴 (Anti-Patterns)
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*