Ai 마법서

Part 3. 컨텍스트 엔지니어링 (캔버스)

3 min read

⚙️ Context Engineering

AI가 작업하는 환경 전체를 설계하는 기술

“어떻게 물어볼까” (Prompt Engineering) → “어떤 환경을 줄까” (Context Engineering)

AI 출력 품질 = 모델 능력 × Context 품질

4가지 Context 요소

Context역할구현
📋 규칙팀 코딩 규칙/금지사항CLAUDE.md
📚 지식사내 API 정확한 사용법Skills (hmeg-api RAG)
🔄 패턴기존 동작하는 코드 구조examples/
🎯 작업기능 구현 구체적 지시PRPs/

5가지 구성 요소

📄 CLAUDE.md

프로젝트 헌법. 세션 시작 시 자동 로드.

  • 개발 명령어, 필수 규칙, 프로젝트 구조
  • 규칙: using 필수 / try-catch 필수 / 이모지 금지

🔍 Skills (.claude/skills/hmeg-api/)

외부 도구 연동. Google Gemini RAG로 HmEG 문서 검색.

  • HmEG.md → 벡터 스토어 업로드 → 의미론적 검색
  • 실제 API 시그니처 + Citation → 할루시네이션 방지

⚡ Commands (.claude/commands/)

슬래시 명령어로 호출하는 표준 프롬프트.

  • /generate-prp : 기능 요청 → PRP 설계서 생성
  • /execute-prp : PRP → 실제 코드 구현

🤖 Subagents (.claude/agents/)

전문 역할의 자율 AI 서브프로세스.

  • validation-gates : 빌드/테스트 자동 검증 ⭐
  • architecture-manager : PlantUML 다이어그램 생성
  • code-analyst : 기존 코드 패턴 분석

🪝 Hooks (.claude/hooks/)

생명주기 이벤트에 결정론적으로 실행되는 쉘 스크립트.

  • PreToolUse : 위험 명령(rm .env 등) 차단
  • PostToolUse : 파일 편집 후 자동 로그

개발 워크플로우

INITIAL.md 작성
     ↓
/generate-prp  →  PRPs/feature_prp.md  (API 조회 마커 포함)
     ↓
  검토/수정 (사람이 확인)
     ↓
/execute-prp   →  hmeg-api Skill 자동 호출  →  코드 구현
     ↓
validation-gates  →  build + test
     ↓
✅ 완료

📝 PRPs

AI가 첫 시도에 올바른 코드를 생성하기 위한 구조화된 작업 지시서

  • [API 조회 필요: ClassName] 마커로 할루시네이션 방지
  • 구현 단계 + 검증 게이트 + 위험 완화 포함

💡 examples/

AI의 코드 패턴 학습 자료

  • snippets/ : 단일 API 사용 최소 예제 (AddBox.cs 등)
  • EGViewportSample/ : 완전한 MVVM 구현 참조

관련 노트

Graph View

Backlinks