01-개념

01. 개념 — 왜 CLAUDE.md가 “최고 레버리지”인가

모델은 학습하지 않는다

HumanLayer Kyle의 글 “Writing a Good CLAUDE.md”(2025-11-25)는 한 문장에서 시작한다.

“LLMs are stateless. Models don’t learn over time — they only know the tokens you provide.”

의역: “LLM은 상태가 없다. 모델은 시간이 지나도 학습하지 않는다 — 제공된 토큰만 안다.”

CLAUDE.md는 모든 에이전트 대화의 컨텍스트에 매번 자동으로 합쳐진다. 그래서 코드베이스 지식을 모델에 전달하는 primary mechanism — 주된 통로 다.

”왜 Claude는 자주 무시하나”

같은 글의 솔직한 진단:

Claude Code’s system reminder states the context “may or may not be relevant” and instructs Claude to disregard it unless highly applicable.

의역: Claude Code의 시스템 리마인더는 컨텍스트가 “관련 있을 수도 없을 수도 있다”고 말하며, 매우 관련된 경우가 아니면 무시하라고 지시한다.

이 문장이 핵심이다. 모든 디렉티브가 똑같이 강하게 작동하지 않는다. 광범위하게 적용되는 지시문은 주의를 받고, 곁가지 지시문은 걸러진다. 그래서 디렉티브를 마구 늘리면 오히려 핵심까지 같이 무시당한다.

프론티어 모델의 지시문 한계

“Frontier LLMs reliably follow 150-200 instructions; smaller models degrade exponentially with more.”

의역: “프론티어 LLM은 150~200개 지시문까지 안정적으로 따르고, 작은 모델은 그 이상에서 지수적으로 무너진다.”

이는 “한 페이지 분량”이 단순한 미감 문제가 아니라는 뜻이다. 인지 예산이다.

OMC의 정체성 선언

OMC CLAUDE.md 첫 문장은 좋은 본보기다.

“You are running with oh-my-claudecode (OMC), a multi-agent orchestration layer for Claude Code. Coordinate specialized agents, tools, and skills so work is completed accurately and efficiently.”

정체성·역할·기대치가 세 줄 안에 들어 있다. 그 다음에는 <operating_principles>, <delegation_rules>, <model_routing> 같은 XML 태그로 절을 나눠 모델이 절 단위로 인용하기 쉽게 만든다.