맥락(Context) 관리

🧠 AI는 당신의 프로젝트를 모른다

새 대화를 시작할 때마다 AI는 완전한 빈 상태에서 시작합니다. 여러분의 프로젝트 구조, 팀의 코딩 스타일, 지금까지 쌓아온 결정들을 AI는 전혀 모릅니다. 맥락(Context)은 여러분이 직접 제공해야 합니다. 이 강의에서는 어떤 맥락을 어떻게 제공해야 효과적인지 배웁니다.

📂 기법 1 — 관련 파일 직접 지정하기

AI 에디터(Cursor, Windsurf)에서는 @파일명 또는 파일을 드래그하는 방식으로 특정 파일을 맥락에 포함할 수 있습니다. Claude Code에서는 /add 커맨드나 파일을 직접 언급합니다.

@types/user.ts @app/users/page.tsx
users 페이지에서 User 타입을 기반으로 사용자 카드 컴포넌트를 만들어줘. 카드에는 name, email, createdAt을 보여줘.

이처럼 관련 파일을 명시하면 AI가 기존 타입 정의를 그대로 활용해, 타입 불일치나 중복 정의 같은 문제를 스스로 방지합니다.

📜 기법 2 — 프로젝트 규칙 파일 만들기

매번 기술 스택과 컨벤션을 설명하는 건 비효율적입니다. 한 번 규칙 파일을 만들어두면 AI가 항상 그 파일을 참고합니다.

주요 AI 도구의 규칙 파일:

도구	파일명	위치
Claude Code	CLAUDE.md	프로젝트 루트
Cursor	.cursorrules	프로젝트 루트
Windsurf	.windsurfrules	프로젝트 루트

규칙 파일에 담을 내용:

• 기술 스택 ("Next.js 15 App Router + TypeScript + Tailwind CSS")
• 폴더 구조 요약 ("페이지는 app/ 아래, 컴포넌트는 components/")
• 코딩 규칙 ("함수형 컴포넌트만 사용, class 컴포넌트 금지")
• 명명 규칙 ("파일명은 kebab-case, 컴포넌트명은 PascalCase")
• 금지 사항 ("console.log 대신 로거 사용, any 타입 금지")

💡 팁: 규칙 파일이 있으면 신규 팀원이 AI를 쓸 때도 자동으로 팀 컨벤션을 따르게 됩니다 — 온보딩 자료 겸 AI 가이드 역할을 합니다.

🗂️ 기법 3 — 프로젝트 구조를 설명하기

AI가 프로젝트 전체를 이해하려면 구조를 알아야 합니다. 처음 작업할 때 구조를 한 번 설명하거나, AI에게 직접 파악하게 해봅니다:

이 프로젝트의 폴더 구조를 파악하고, 주요 파일과 각 파일의 역할을 간단히 정리해줘.

AI가 구조를 파악한 뒤에는 "users 관련 코드는 app/users/ 안에 있으니 거기서 찾아줘" 같은 간단한 힌트만으로도 충분합니다.

⚖️ 맥락 과다의 비용 — 너무 많이 줘도 문제

맥락을 많이 줄수록 좋을 것 같지만, 그렇지 않습니다. 너무 많은 정보는 오히려 AI를 혼란스럽게 만들고, 핵심에서 벗어난 결과를 만들기도 합니다. 또한 AI 도구는 처리할 수 있는 맥락의 양(컨텍스트 창)에 한계가 있습니다.

맥락 과다의 신호:

• AI가 관련 없는 파일의 코드를 건드리기 시작할 때
• 요청하지 않은 기능이 추가될 때
• 응답이 지나치게 길어질 때

이럴 때는 새 대화를 시작하고 핵심 맥락만 다시 제공하세요.

🎯 적정 맥락 잡기 — 실전 기준

• 단순 작업 (버튼 색 바꾸기, 텍스트 수정): 맥락 최소화 — 해당 파일 하나만
• 새 기능 추가: 관련 타입 파일 + 추가할 위치 파일 + 기술 스택 명시
• 복잡한 리팩토링: 규칙 파일 + 관련 파일 전체 + 목적 명확히
• 버그 수정: 에러 메시지 전체 + 에러 발생 파일 + 재현 방법

✅ 정리

• AI는 당신이 보여준 것만 압니다 — 관련 파일을 명시적으로 지정하세요.
• 규칙 파일(CLAUDE.md / .cursorrules 등)을 한 번 만들어두면 매번 설명 없이 컨벤션이 유지됩니다.
• 맥락은 많을수록 좋은 게 아닙니다 — 작업에 꼭 필요한 것만 골라 제공하는 것이 핵심입니다.
• 대화가 길어지면 새 대화를 시작하고 핵심 맥락을 다시 제공하는 게 효율적입니다.