이 페이지의 목차
확인 2026-10-18근거 자료 6건갱신 2026-10-26언급 14곳
이 페이지의 목차

정의#

LLM 에이전트에게 위키가 어떻게 구성돼 있는지, 어떤 규칙을 따르는지, 자료 수집·질의·유지보수 때 어떤 워크플로를 밟는지를 알려 주는 문서다. LLM Wiki의 세 번째 레이어다. Karpathy LLM Wiki

  • Claude Code에서는 CLAUDE.md(용어 사전). Claude Code에서 이 파일은 매 세션 자동으로 로드되는 지속 컨텍스트다(→ 메모리(CLAUDE.md)). Claude Code 확장 기능 개요
  • Codex에서는 AGENTS.md. (2026-10-18 기준) Codex는 작업 전에 이 파일을 읽어, Codex 홈(~/.codex)의 전역 지시와 프로젝트 루트에서 현재 디렉터리까지의 파일을 이어 붙인 지시 체인을 만든다. Codex AGENTS.md 가이드 → Codex
  • (2026-10-18 기준) Claude Code도 AGENTS.md를 프로젝트 지시로 읽을 수 있다. 기본값으로는 작업 디렉터리나 그 위에 CLAUDE.md가 없을 때만 읽고, 설정으로 둘 다 읽게 할 수 있다(v2.1.277 이상). 두 도구를 오가는 위키라면 한 파일을 공유할 수 있다. Claude Code 메모리 → AGENTS.md와 CLAUDE.md 함께 쓰기
  • (2026-10-18 기준) Gemini CLI와 Antigravity CLI는 같은 워크스페이스 컨텍스트 규칙을 쓴다. 현재 디렉터리의 GEMINI.md와 AGENTS.md, 전역 ~/.gemini/GEMINI.md를 읽고, Gemini CLI에서 Antigravity CLI로 옮길 때 기존 규칙 문서는 고칠 필요가 없다고 공식 이전 문서는 말한다. Gemini CLI에서 Antigravity CLI로 이전 → Gemini CLI에서 Antigravity CLI로 옮기기
  • (2026-10-21 기준) Antigravity 공식 Rules 문서는 이런 지속 지시를 "규칙(rules)"이라 부른다. 파일을 읽거나 고칠 때 그 폴더에서 워크스페이스 루트까지 올라가며 AGENTS.md·GEMINI.md·.agents/rules/*.md를 로드하고, 전역(~/.gemini/AGENTS.md 등)·워크스페이스·디렉터리 규칙을 대체하지 않고 모두 합치며, 충돌하면 더 구체적인 디렉터리 규칙이 앞선다. AGENTS.md·GEMINI.md는 frontmatter 없이 항상 활성이고, rules/ 안 파일은 trigger(always_on·model_decision·glob·manual)로 언제 넣을지 정한다. Antigravity 규칙 문서 → Antigravity CLI, AGENTS.md와 CLAUDE.md 함께 쓰기

근거: Karpathy LLM Wiki (원본은 이 두 파일을 예시로 든다)

왜 핵심인가#

원본은 스키마를 "핵심 설정 파일"이라 부른다. 스키마가 있어야 LLM이 범용 챗봇이 아니라 규율 있는 위키 관리자로 움직인다. Karpathy LLM Wiki

어떻게 다루는가#

  • 처음부터 완성하지 않는다. 사용자와 LLM이 자기 분야에 무엇이 맞는지 알아가며 함께 진화시킨다. Karpathy LLM Wiki
  • 작업 방식(예: 자료를 하나씩 넣을지 한꺼번에 넣을지)을 정했으면 다음 세션을 위해 스키마에 적어 둔다. Karpathy LLM Wiki → LLM Wiki 수집(Ingest)

스키마에 들어가는 것#

원본이 스키마의 역할로 든 항목:

  1. 위키 구조
  2. 규칙(컨벤션)
  3. 자료 수집 워크플로
  4. 질문 답변 워크플로
  5. 위키 유지보수 워크플로

근거: Karpathy LLM Wiki

Codex에서 스키마를 쓸 때의 제약 (2026-10-18 기준)#

  • 합친 지시가 project_doc_max_bytes(기본 32 KiB)에 닿으면 Codex는 파일을 더 넣지 않는다. 한도를 올리거나 하위 디렉터리로 나누라고 원본은 말한다. Codex AGENTS.md 가이드
  • 디렉터리마다 한 파일만 읽고, AGENTS.override.md가 있으면 같은 디렉터리의 AGENTS.md는 무시된다. 원본은 엉뚱한 지시가 나오면 디렉터리 트리 위쪽이나 Codex 홈의 AGENTS.override.md를 찾으라고 한다. Codex AGENTS.md 가이드
  • 지시 체인은 실행마다(TUI는 세션 시작마다) 다시 만들어진다. 지시가 낡아 보이면 대상 디렉터리에서 Codex를 다시 시작하라고 원본은 말한다. 손으로 지울 캐시는 없다. Codex AGENTS.md 가이드
  • 두 도구를 오가는 위키라면 탐색 규칙 차이를 AGENTS.md와 CLAUDE.md 함께 쓰기의 비교표로 확인한다.

Claude Code에서 스키마를 쓸 때의 제약#

  • CLAUDE.md는 세션 시작 때 전체가 로드돼 매 요청에 들어간다. 공식 문서는 경험칙으로 200줄 이하를 권하고 참고 내용은 스킬로 옮기라고 한다. Claude Code 확장 기능 개요
  • CLAUDE.md에 쓴 규칙은 지시일 뿐 강제되지 않는다. 공식 문서는 매번 지켜져야 하는 규칙이면 프롬프트 지시가 아니라 훅으로 만들라고 한다. 원본 예는 .env 편집을 막는 PreToolUse 훅이다. Claude Code 확장 기능 개요
  • 공식 메모리 문서는 지시를 확인할 수 있게 구체적으로 쓰고, 파일당 200줄 이하를 목표로 하며, 서로 모순되는 지시를 주기적으로 지우라고 한다. 모순되면 Claude가 하나를 임의로 고를 수 있기 때문이다. 위키 스키마가 길어지면 일부에만 해당하는 규칙은 .claude/rules/나 스킬로 나눌 수 있다. Claude Code 메모리 → CLAUDE.md 작성·구성