Files

T

Antigravity Agent f8b21af4be Wiki cleanup: error-doc removal, dedup merge, link normalization

10_Wiki/Topics 대규모 정리:
- 오류 캡처/미완성 stub 문서 227개 제거
- 교차폴더 중복 43클러스터 병합 (63파일 → redirect)
- 링크명 정규화: 깨진 링크 수정·redirect 직결·개념 매핑 ~2,400건
- 카테고리 MOC 6개 신규 생성
- Graph 섹션 미해결 related-keyword 링크 10,058건 제거

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-20 23:52:15 +09:00

4.6 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack

title

Interface Segregation Principle (ISP)

📌 한 줄 통찰 (The Karpathy Summary)

인터페이스 분리 원칙(Interface Segregation Principle, ISP)은 클라이언트가 자신이 사용하지 않는 동작이나 액션에 의존하도록 강요받아서는 안 된다는 소프트웨어 설계 원칙입니다 [1, 2]. 이 원칙은 불필요한 기능까지 묶여 있는 방대한 '뚱뚱한(fat)' 인터페이스 대신, 목적이 뚜렷하고 초점이 맞춰진(focused) 인터페이스를 사용할 것을 권장합니다 [2]. 이를 통해 각 클라이언트는 정확히 필요한 기능에만 의존할 수 있으며, 불필요한 코드의 무게를 줄이고 테스트 및 업그레이드를 단순화할 수 있습니다 [3].

📖 구조화된 지식 (Synthesized Content)

초점이 맞춰진 계약(Focused Contracts): ISP는 SOLID 원칙의 'I'에 해당하며, 클라이언트가 사용하지 않는 인터페이스에 의존하지 않도록 계약의 범위를 명확히 제한해야 함을 강조합니다 [1, 2].
분리의 신호(Sign to Split): 인터페이스에 하나 이상의 '도메인 동사(domain verb)'가 포함되어 있다면(예: play, record, stream 기능을 모두 포함한 MediaPlayer 인터페이스), 이는 해당 인터페이스를 분리해야 한다는 강력한 신호입니다 [2, 3].
유연한 조합과 의존성 최소화: 기존의 방대한 인터페이스를 Playable, Recordable, Streamable과 같이 분리된 단위로 쪼개면, 클라이언트는 필요한 인터페이스만 선택적으로 가져올 수 있습니다 [3]. 이는 불필요한 의존성(dead weight)을 제거하여 향후 시스템 업그레이드와 테스트 과정을 크게 단순화합니다 [3].
결합도 감소와 확장성 확보: 하나의 인터페이스가 너무 많은 책임을 갖게 되면 시스템이 변경에 취약해집니다 [4]. 인터페이스를 최소 단위로 분리하고 이를 필요한 시점에 조합하여 사용하는 방식은 시스템 간의 결합도를 낮추고, 수정에는 닫혀 있고 확장에는 열려 있는 견고한 아키텍처를 구축하는 핵심 전략이 됩니다 [4].

⚠️ 모순 및 업데이트 (Contradictions & Updates)

과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
정책 변화: Design & Experience 분야의 자동 자산화 수행.

🔗 지식 연결 (Graph)

Related Topics: , Single Responsibility Principle (SRP), Facade Pattern
Contradictions/Notes: 소스 내에 ISP에 반대되는 주장은 없습니다. 추가적인 참고 사항으로, 소스는 인터페이스에 여러 도메인 동사가 존재할 경우 이를 분리하는 기준으로 삼으라고 조언합니다 [3].

Last updated: 2026-04-18

Raw Source: 00_Raw/2026-04-20/Interface Segregation Principle (ISP).md

🤖 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: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)

# TODO

🤔 의사결정 기준 (Decision Criteria)

선택 A를 써야 할 때:

(TODO)

선택 B를 써야 할 때:

(TODO)

기본값:

(TODO)

❌ 안티패턴 (Anti-Patterns)

[안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)

4.6 KiB Raw Blame History