Files

T

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

2026-05-08 19:52:07 +09:00

3.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

Discriminated Unions (판별 가능한 유니온)

📌 한 줄 통찰 (The Karpathy Summary)

"타입 가드를 자동화하는 영리한 리터럴 태그" — 공통된 속성(Tag)을 기준으로 여러 타입을 하나로 묶고, 코드 레벨에서 안전하게 특정 타입을 식별해낼 수 있게 하는 타입 설계 기법.

📖 구조화된 지식 (Synthesized Content)

추출된 패턴: 여러 객체 타입이 공통적으로 가지는 '태그(Literal property)'를 사용하여 컴파일러가 조건문(switch, if) 내에서 타입을 정확히 좁힐 수 있도록 돕는 패턴.
세부 내용:
- Tag/Kind 속성: 각 타입에 고유한 문자열 리터럴 속성을 부여하여 구분의 근거를 마련.
- Exhaustiveness Check: switch 문에서 모든 가능한 케이스를 처리했는지 TypeScript 컴파일러가 확인하게 함.
- Error Handling: Success와 Failure 타입을 유니온으로 묶어 런타임 에러 대신 컴파일 타임에 예외 처리를 강제.
- Pattern Matching: 함수형 언어의 패턴 매칭과 유사한 안정성을 객체 지향 환경에서 구현.

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

과거 데이터와의 충돌: instanceof나 임의의 속성 체크 기반의 불안정한 타입 가드에서, 명시적인 '태그' 기반의 선언적 타입 가드로 표준화됨.
정책 변화: Antigravity 에이전트의 통신 프로토콜 정의 시, 메시지 타입을 Discriminated Unions로 정의하여 파싱 오류를 원천 차단함.

🔗 지식 연결 (Graph)

Parent: 10_Wiki/💡 Topics/AI
Related: Type-Guards, Algebraic-Data-Types, Exhaustiveness-Checking
Raw Source: 10_Wiki/Topics/AI/Discriminated-Unions-for-Error-Handling.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: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)

3.6 KiB Raw Blame History