[G1-Sync] Manual knowledge update

10_Wiki/Topics/Coding/Guard_Clauses.md

@@ -0,0 +1,107 @@
+---
+id: guard-clauses
+title: 가드 조항으로 중첩 줄이기 (Guard Clauses)
+category: Coding
+status: draft
+canonical_id: guard-clauses
+aliases: [early return, fail fast, precondition check, 조기 리턴]
+duplicate_of: null
+source_trust_level: C
+confidence_score: 0.85
+verification_status: conceptual
+created_at: 2026-05-09
+updated_at: 2026-05-09
+last_reinforced: 2026-05-09
+review_reason: ""
+merge_history: []
+tags: [coding, control-flow, readability, refactoring, vibe-coding]
+raw_sources: ["P-Reinforce session 2026-05-09 — bulk Coding seed batch 1"]
+tech_stack:
+  language: "TypeScript / JavaScript / Python / Go"
+  applicable_to: ["Backend", "Frontend", "Scripts"]
+applied_in: []
+---
+
+# 가드 조항으로 중첩 줄이기
+
+> 함수 본문은 "정상 경로 한 줄"에 가깝게 만든다. 비정상 조건은 모두 위로 보내고 즉시 return / throw.
+
+## 📖 핵심 개념
+
+**가드 조항(guard clause)** 은 함수의 시작 부분에 놓는 빠른 종료 분기다. `if (조건 위반) return;` 형태로 비정상 입력·상태를 먼저 거른 뒤, 함수 본문 나머지는 "정상 경로 가정" 으로 작성한다.
+
+핵심 효과:
+- 들여쓰기 깊이 감소 → 인지 부하 감소
+- 정상 경로가 함수 끝에 모이므로 핵심 로직이 읽기 쉬움
+- 각 가드는 독립적인 invariant 표현 → 테스트가 각 분기를 좁게 잡을 수 있음
+
+## 💻 코드 패턴
+
+**나쁜 예 — 화살표 모양**:
+```ts
+function publish(post: Post): Result {
+  if (post) {
+    if (post.author) {
+      if (post.author.verified) {
+        if (post.body.length > 0) {
+          return doPublish(post);
+        } else {
+          return { ok: false, reason: 'EMPTY_BODY' };
+        }
+      } else {
+        return { ok: false, reason: 'UNVERIFIED' };
+      }
+    } else {
+      return { ok: false, reason: 'NO_AUTHOR' };
+    }
+  } else {
+    return { ok: false, reason: 'NO_POST' };
+  }
+}
+```
+
+**가드 조항 적용**:
+```ts
+function publish(post: Post): Result {
+  if (!post) return { ok: false, reason: 'NO_POST' };
+  if (!post.author) return { ok: false, reason: 'NO_AUTHOR' };
+  if (!post.author.verified) return { ok: false, reason: 'UNVERIFIED' };
+  if (post.body.length === 0) return { ok: false, reason: 'EMPTY_BODY' };
+
+  return doPublish(post);
+}
+```
+
+## 🤔 의사결정 기준
+
+| 상황 | 가드 조항 적합 | 분기문 적합 |
+|---|---|---|
+| 비정상 입력을 일찍 걸러야 함 | ✅ | ❌ |
+| 분기 두 갈래가 비슷한 비중을 가짐 | ❌ | ✅ |
+| 두 분기 모두 후속 로직이 길고 비슷함 | ❌ (전략 패턴 고려) | — |
+| 가드 위반 시 cleanup 필요 | ✅ + try/finally | — |
+| 성능이 극단적으로 중요한 핫패스 | ✅ (조기 종료가 빠름) | — |
+
+## ❌ 안티패턴
+
+- **`else` 가 따라붙는 가드**: `if (!x) return; else { ... }` — `else`는 무의미. 본문은 그냥 다음 줄로.
+- **가드 안에서 추가 로직 수행**: 가드는 "검사 + 종료"만. 부작용을 가드에 끼워넣으면 함수 시작부에 숨겨진 동작이 생김.
+- **타입 좁히기 누락**: TypeScript에서 `if (!x) return;` 후에는 `x`가 non-nullish로 좁혀져야 한다. 타입 가드(`x is Foo`) 형태가 필요하면 별도 helper로.
+- **너무 많은 가드 (6개 이상)**: 함수가 너무 많은 invariant를 책임지고 있다는 신호. 입력을 먼저 정규화하거나 별도 validator로 추출.
+
+## 🤖 LLM 활용 힌트
+
+- LLM에게 함수 작성을 시킬 때 "**가드 조항 우선, else 사용 금지**" 라고 명시하면 화살표 코드를 거의 안 만든다.
+- 기존 코드 리팩터링을 시킬 때는 "들여쓰기 4단계 이상이면 가드로 펼쳐줘" 라고 구체적 임계값을 줘야 일관성이 생김.
+
+## 🧪 검증 상태
+
+- verification_status: `conceptual`
+- 일반 코딩 베스트 프랙티스(Refactoring 책, Clean Code 등)에서 표준 패턴.
+- 실제 적용 사례는 코드베이스에서 발견되면 `applied_in` 에 추가.
+
+## 🔗 관련 문서
+
+- [[Pure_Functions_in_Practice]]
+- [[Null_Safety_Patterns]]
+- [[Error_Handling_Result_vs_Throw]]