c24165b8bc
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게 [공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류. 문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인). - Topic_Programming → Domain_Programming (내부 구조 보존) - Topic_Graphic → Domain_Design - Topic_Business → Domain_Product - Topic_General → Domain_General - _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning), Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing) - 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서) - 빈 폴더 정리 (memory/procedures) - 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
6.2 KiB
6.2 KiB
id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack
| id | title | category | status | canonical_id | aliases | duplicate_of | source_trust_level | confidence_score | verification_status | tags | raw_sources | last_reinforced | github_commit | tech_stack | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| wiki-2026-0508-추상화-abstraction | 추상화(Abstraction) | 10_Wiki/Topics | verified | self |
|
none | A | 0.9 | applied |
|
2026-05-10 | pending |
|
추상화(Abstraction)
매 한 줄
"매 essential 의 의 keep, 매 incidental 의 의 hide". 매 complexity management 의 의 의 의 의 핵심 의 mechanism — 매 detail 의 의 selectively 의 의 의 reveal 의 의 conceptual model 의 의 의 expose. 매 SOLID 의 D (Dependency Inversion) 의 의 의 foundation.
매 핵심
매 Abstraction 의 의 의 forms
- Procedural — 매 function 의 의 의 의 의 step 의 hide.
- Data — 매 representation 의 의 의 의 hide (ADT).
- Control — 매 flow 의 의 의 hide (iterator, async).
- Type — 매 generic / parametric polymorphism.
- Interface — 매 contract 의 의 의 의 의 expose, impl 의 의 의 hide.
매 Levels of abstraction
- High — 매 business domain ("place order").
- Mid — 매 application logic ("validate cart").
- Low — 매 implementation ("HTTP POST").
- Hardware — 매 CPU instruction.
매 핵심 properties
- Information hiding (Parnas, 1972) — 매 client 의 의 의 의 implementation 의 의 의 X.
- Encapsulation — 매 state + behavior 의 의 의 의 bundle.
- Substitutability (LSP) — 매 abstraction 의 의 의 의 의 satisfy 의 implementation 의 의 의 의 swap 의 의 가능.
매 vs Encapsulation
- 매 Abstraction = 매 "what" — 매 의 logical model.
- 매 Encapsulation = 매 "how" — 매 mechanism (private, accessor).
💻 패턴
매 Procedural abstraction
def calculate_invoice_total(invoice: Invoice) -> Money:
subtotal = sum_line_items(invoice.lines)
discount = apply_discounts(subtotal, invoice.coupons)
tax = compute_tax(subtotal - discount, invoice.address)
return subtotal - discount + tax
매 Data abstraction (ADT)
from abc import ABC, abstractmethod
class Stack[T](ABC):
@abstractmethod
def push(self, item: T) -> None: ...
@abstractmethod
def pop(self) -> T: ...
@abstractmethod
def peek(self) -> T: ...
@abstractmethod
def is_empty(self) -> bool: ...
# 매 ArrayList 의 의 의 implementation, LinkedList 의 의 의 의 implementation — 매 swap 가능
매 Interface (contract)
interface PaymentGateway {
charge(userId: string, amount: Money): Promise<ChargeResult>;
refund(chargeId: string): Promise<RefundResult>;
}
class StripeGateway implements PaymentGateway { /* ... */ }
class AdyenGateway implements PaymentGateway { /* ... */ }
class FakeGateway implements PaymentGateway { /* test */ }
매 Dependency inversion
// 매 High-level 의 의 의 abstraction 의 의 의 의 의 depend, 매 low-level impl 의 의 의 X.
class OrderService {
private final PaymentGateway gateway; // 매 abstraction
public OrderService(PaymentGateway gw) { this.gateway = gw; }
}
매 Type abstraction (generic)
fn largest<T: PartialOrd>(list: &[T]) -> &T {
let mut largest = &list[0];
for item in list {
if item > largest { largest = item; }
}
largest
}
매 Control abstraction (iterator)
def first_match(items: Iterable[T], pred: Callable[[T], bool]) -> T | None:
for item in items:
if pred(item): return item
return None
# 매 list, generator, file, stream 의 의 모두 의 의 의 work
매 Leaky abstraction (Joel Spolsky)
# 매 Bad — 매 underlying TCP 의 의 의 의 의 leak
def send(msg):
try: socket.send(msg)
except ConnectionResetError: ... # 매 abstraction 의 의 의 의 의 break
# 매 Better — 매 wrap
class MessageBus:
def send(self, msg) -> SendResult:
try: self._socket.send(msg); return SendResult.OK
except: return SendResult.RETRY
매 Higher-Kinded abstraction
trait Functor[F[_]] {
def map[A, B](fa: F[A])(f: A => B): F[B]
}
// 매 List, Option, Future 의 의 모두 의 Functor — 매 abstraction 의 의 의 매 type constructor 의 의 over
매 결정 기준
| 상황 | Approach |
|---|---|
| 매 detail 의 의 의 client 의 의 의 의 X 의 의 needed | 매 hide via 매 interface |
| 매 multiple impl 의 의 의 expected | 매 abstract class / interface |
| 매 single use, single impl | 매 직접 — 매 premature abstraction 의 X |
| 매 stable detail | 매 leak 의 의 의 의 의 fine — 매 simplicity 의 win |
| 매 cross-process boundary | 매 strong abstraction (RPC, queue) |
기본값: 매 rule of three — 매 셋 의 의 의 의 의 occur 의 의 의 의 abstract.
🔗 Graph
- 변형: Encapsulation · Information Hiding · Polymorphism
- 응용: SOLID · Hexagonal Architecture · Clean Architecture
- Adjacent: TypeScript 타입 시스템 (TypeScript Type System)
🤖 LLM 활용
언제: 매 design — 매 boundary 의 의 의 draw, 매 변경 의 의 absorb 의 의 의 abstraction layer 의 의 의 introduce. 언제 X: 매 single-call site, 매 prototype — 매 premature abstraction 의 의 의 cost.
❌ 안티패턴
- Premature abstraction: 매 한 implementation 의 의 의 의 의 interface 의 의 introduce — 매 noise.
- Leaky abstraction: 매 underlying detail 의 의 의 의 surface — 매 client 의 의 의 의 know 의 의 force.
- God interface: 매 모든 의 method 의 의 의 의 한 interface 의 의 — ISP 의 violation.
- Wrong abstraction (Sandi Metz): 매 잘못 의 abstraction 의 의 의 duplication 의 의 보다 의 worse.
🧪 검증 / 중복
- Verified — Parnas (1972) "On the Criteria To Be Used in Decomposing Systems"; Joel Spolsky "Law of Leaky Abstractions"; Sandi Metz, Practical Object-Oriented Design.
- 신뢰도 A.
🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — abstraction forms + leaky / wrong-abstraction discussion |