Vibe Coding 의 컨텍스트 엔지니어링 — 망각·드리프트·부패에 맞서는 외재화
별칭: VBC 컨텍스트 엔지니어링 · context engineering for vibe coding · CLAUDE.md 가 곧 spec
요약
컨텍스트 엔지니어링은 AI 의 기억 공백을 외재화된 문서로 메우는 작업이다. Vibe Coding 의 3개월의 벽 (유포리아 → 혼돈 → 붕괴) 의 직접 원인은 AI 약함이 아니라 인간이 구조를 안 줘서 다. AI 는 매 세션마다 망각하고, 매 응답마다 드리프트하며, 긴 대화에서 부패한다. 이를 방지하는 단 한 가지 방법은 세션 외부에 영구 지시어를 박아 두는 것 — term/claude-md / term/agents-md / term/cursorrules / Plan Mode / Subagent. 이것이 곧 AI 에게 어떻게 일을 시키는가가 곧 설계도이다 (Corollary) 의 작동 형태다.
상세
Vibe Coding 의 3대 컨텍스트 결함
| 결함 | 메커니즘 | 결과 |
|---|---|---|
| 망각 (Forgetting) | 세션이 끝나면 모든 결정 사항이 사라짐 | 다음 세션에서 다시 처음부터 동일한 합의를 반복 |
| 드리프트 (Drift) | 같은 세션 안에서도 term/context-window 한계로 초기 합의가 밀려남 | 새 코드가 기존 패턴과 충돌, term/requirements-drift |
| 부패 (concept/context-rot) | 긴 대화 누적 → AI 의 판단력 저하 | 일관성 상실, 어제는 잘 했는데 오늘은 못 하는 현상 |
→ 7 건의 사고 (case/anthropic-incident-log / case/lemkin-replit-db-deletion / case/pocketos-cursor-db-deletion 등) 가 모두 이 3 결함의 변형. AI 가 약해서가 아니라 우리가 컨텍스트를 안 줘서 망한다.
4 종 영구 지시어 (Persistent Instructions)
세션이 죽어도 살아남는 외재화된 컨텍스트. 한 줄 요약: "세션 = 휘발, 파일 = 영구".
| 도구 | 형태 | 적용 범위 | 본 강의 위치 |
|---|---|---|---|
| term/claude-md | 마크다운 한 파일 | Claude Code 세션 자동 로드 | 14 장 (DSL) — AI 시대의 압축 설계 문서 |
| term/agents-md | 마크다운 한 파일 | OpenAI Codex 세션 자동 로드 | 14 장 |
| term/cursorrules | 마크다운 한 파일 | Cursor IDE 자동 로드 | 14 장 |
| term/persistent-instructions | 추상 개념 | 위 3 종의 상위 카테고리 | 본 카드 |
→ CLAUDE.md / AGENTS.md / .cursorrules 셋은 도구 별 방언이고, 영구 지시어 가 그 언어 다.
컨텍스트 엔지니어링 5 종 체크리스트 (학생 즉시 적용)
- CLAUDE.md 우선 — 첫 줄: 프로젝트 목적·도메인·금지 사항. 세션마다 다시 설명할 필요 ❌.
- Plan Mode 후 작업 — Karpathy case/karpathy-plan-mode-tweet 의 핵심: 코드 쓰기 전에 계획 외재화.
- Subagent 분리 — 컨텍스트 부패 차단. 큰 작업은 작은 에이전트의 집합으로.
- 검증 루프 박아 두기 — pre-commit hook / Stop hook / pytest 자동 호출. AI 의 마지막 점검을 코드로 강제.
- 세션 종료 전 요약 → CLAUDE.md 갱신 — 다음 세션의 첫 컨텍스트 가 된다.
Vibe Coding ↔ Spec-Driven Development 의 화해
VBC 의 환상 은 "기획서 없이도 된다" — 실패. SDD 의 극단 은 "모든 spec 을 먼저 쓴다" — 느림. CLAUDE.md 가 둘의 화해점 — 최소 spec (도메인 / 금지 / 검증 기준) 만 외재화하고, 구현은 vibe 로. concept/spec-driven-development 의 정신을 경량화한 형태.
본 카드와 표어의 관계
- Thesis: "설계 없이는 코딩이 안된다" — 본 카드의 5 종 체크리스트가 설계의 외재화 수단.
- Corollary: "AI 에게 어떻게 일을 시키는가가 곧 설계도이다" — 어떻게 일을 시키는가 의 어휘가 영구 지시어 4종.
- 한 메시지: "CLAUDE.md 를 쓰는 순간, 여러분은 설계자다." (마지막 페이지 회수)
주의사항
- CLAUDE.md 를 너무 자세히 쓰면 term/context-window 부담 ↑. 핵심만 박고 깊은 내용은 링크 로 분기.
- 영구 지시어는 살아 있는 문서 — 잘못된 합의가 박히면 AI 가 그 잘못을 고집. 정기 lint 필요 (concept/multi-layer-guardrail 의 외부층).
- 모든 결정 을 외재화하려는 욕심은 term/requirements-drift 의 다른 형태. 생산적 게으름 으로 핵심만.
표어 정합
본 카드의 컨텍스트 엔지니어링 정의가 강의 표어 "AI-Native Vibe Coding: No Design, No Code" 의 작동 메커니즘 이다. 설계 없이는 코딩이 안된다 (Thesis) 의 설계 가 영구 지시어 4 종 으로 박히고, AI 에게 어떻게 일을 시키는가 (Corollary) 의 어휘 가 본 카드의 5 종 체크리스트로 외재화된다.