Files

T

Antigravity Agent 93ec7e9056 [G1-Sync] Manual knowledge update

2026-05-09 21:08:02 +09:00

4.0 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, created_at, updated_at, last_reinforced, review_reason, merge_history, tags, raw_sources, tech_stack, applied_in

title

가드 조항으로 중첩 줄이기

함수 본문은 "정상 경로 한 줄"에 가깝게 만든다. 비정상 조건은 모두 위로 보내고 즉시 return / throw.

📖 핵심 개념

가드 조항(guard clause) 은 함수의 시작 부분에 놓는 빠른 종료 분기다. if (조건 위반) return; 형태로 비정상 입력·상태를 먼저 거른 뒤, 함수 본문 나머지는 "정상 경로 가정" 으로 작성한다.

핵심 효과:

들여쓰기 깊이 감소 → 인지 부하 감소
정상 경로가 함수 끝에 모이므로 핵심 로직이 읽기 쉬움
각 가드는 독립적인 invariant 표현 → 테스트가 각 분기를 좁게 잡을 수 있음

💻 코드 패턴

나쁜 예 — 화살표 모양:

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' };
  }
}

가드 조항 적용:

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 에 추가.

4.0 KiB Raw Blame History