Context Engineering이란?
"프롬프트 엔지니어링"의 다음 단계. 단순히 질문을 잘 하는 것을 넘어,
AI가 작업할 때 참조할 전체 맥락을 체계적으로 설계하는 것.
LLM
CPU
연산 능력 (추론 엔진)
=
Context Window
RAM
작업 메모리 (정보 공간)
Prompt Engineering
사용자가 AI에게 보내는 개별 질문을 잘 작성하는 기술. "이렇게 물어봐라"에 초점을 맞춘다. 일상적인 LLM 사용에서 자주 언급된다.
Context Engineering
AI가 작업할 때 참조하는 전체 맥락을 설계하는 기술. 설정 파일, 코드 컨텍스트, 도구, 히스토리, 예제까지 포괄한다. 산업 수준의 AI 애플리케이션에 필수적이다.
정적 컨텍스트
CLAUDE.md, AGENTS.md, .cursorrules 같은 설정 파일. 프로젝트에 한 번 작성해두면 매 대화에서 자동으로 로드된다. 팀 전체가 공유할 수 있다.
동적 컨텍스트
RAG, 도구 호출 결과, 대화 히스토리 같은 실시간 정보. 컨텍스트 윈도우의 나머지 공간을 상황에 맞게 채운다. 요약과 압축이 핵심이다.
Context Window를 채우는 7가지 요소
Karpathy가 정의한 컨텍스트 윈도우의 핵심 구성요소
1
Task Description
시스템 프롬프트, 사용자 메시지 등 작업 지시. CLAUDE.md나 AGENTS.md가 여기에 해당한다.
2
Few-shot Examples
원하는 출력 형식을 보여주는 예제. 코딩 컨벤션, 커밋 메시지 스타일 등을 예시로 전달한다.
3
RAG (Retrieval-Augmented Generation)
관련 문서, 코드, API 레퍼런스 등을 검색해서 주입. 벡터 DB나 코드 인덱싱이 여기에 해당한다.
4
Multimodal Data
스크린샷, 다이어그램, 로그 파일 등 텍스트 외의 데이터. 디자인 시안이나 에러 스크린샷을 전달한다.
5
Tools
AI가 사용 가능한 도구 정의. 파일 읽기/쓰기, 터미널 실행, 웹 검색 등의 함수 스키마를 포함한다.
6
State & History
대화 히스토리, 이전 도구 호출 결과, 현재 작업 상태. 긴 대화에서는 요약(compaction)이 필수적이다.
7
Compacting / Summarization
컨텍스트 윈도우가 가득 차면 오래된 정보를 요약해서 압축. 중요한 정보는 유지하면서 공간을 확보한다.
AI 코딩 에이전트 설정 파일
각 도구가 사용하는 설정 파일의 구조와 특징을 비교합니다
C
Claude Code
CLAUDE.md
Anthropic의 Claude Code가 매 대화 시작 시 읽는 프로젝트 설정 파일. 빌드 명령어, 코드 스타일, 아키텍처 결정 등 Claude가 코드만으로 유추할 수 없는 정보를 담는다.
A
AGENTS.md
AGENTS.md (Open Standard)
OpenAI Codex CLI에서 시작해 Linux Foundation이 관리하는 개방형 표준. 60,000+ 오픈소스 프로젝트가 채택. Cursor, Claude Code, Continue, Aider 등 다수의 도구가 지원한다.
Cu
Cursor Rules
.cursor/rules/*.mdc
Cursor IDE의 AI 컨텍스트 시스템. 레거시 .cursorrules에서 모듈화된 .cursor/rules/ 디렉토리로 진화. 파일 패턴 기반 자동 활성화, 모델 판단 활성화 등 4가지 트리거 타입을 지원한다.
GH
GitHub Copilot
.github/copilot-instructions.md
GitHub Copilot Chat의 커스텀 지시 시스템. 레포지토리, 파일 경로, 조직 3단계 범위를 지원. 저장 즉시 반영되며 별도 리로드가 필요없다.
W
Windsurf
.windsurf/rules/*.md
Codeium의 Windsurf IDE가 사용하는 Cascade 에이전트 설정. YAML frontmatter로 트리거 조건을 정의. Global, Workspace, System(Enterprise) 3단계 범위를 지원한다.
G
Gemini CLI
GEMINI.md
Google의 Gemini CLI가 사용하는 설정 파일. CLAUDE.md와 유사한 계층 구조. /memory 명령어로 실시간 관리 가능하며 @import 문법을 지원한다.
한눈에 비교
주요 AI 코딩 도구의 설정 파일 스펙 비교
| 도구 | 설정 파일 | 형식 | 계층 구조 | Glob 스코핑 | 트리거 타입 | 크기 제한 | 범용 지원 |
|---|---|---|---|---|---|---|---|
| Claude Code | CLAUDE.md |
Markdown | 3단계 | ✗ (Skills) | Always | ~200줄 권장 | Claude 전용 |
| AGENTS.md | AGENTS.md |
Markdown | 디렉토리 워킹 | ✗ | Always | 32KB | 60K+ 프로젝트 |
| Cursor | .cursor/rules/*.mdc |
MDC | ✗ | Glob 패턴 | 4가지 | 제한 없음 | Cursor 전용 |
| Copilot | .github/copilot-instructions.md |
Markdown | 3단계 | Glob 패턴 | Always | 제한 없음 | GitHub 전용 |
| Windsurf | .windsurf/rules/*.md |
MD+YAML | 3단계 | Glob 패턴 | 4가지 | 6K~12K | Windsurf 전용 |
| Aider | CONVENTIONS.md |
MD+YAML | 3단계 | ✗ | Always | 제한 없음 | Aider 전용 |
| Continue | .continue/rules/*.md |
MD+YAML | 4단계 | Glob+Regex | 조건부 | 제한 없음 | Continue 전용 |
| Gemini CLI | GEMINI.md |
Markdown | 다단계 | ✗ | Always | 제한 없음 | Gemini 전용 |
8+
AI 코딩 도구
60K+
AGENTS.md 채택 프로젝트
4
트리거 타입
1M+
최대 컨텍스트 토큰