Context Engineering Template - 요약
Context Engineering이란?
AI가 작업하는 환경 전체를 설계하는 기술 “어떻게 물어볼까” (Prompt Engineering) → “어떤 환경을 줄까” (Context Engineering)
AI 출력 품질 = 모델 능력 x Context 품질
4가지 Context 요소
| Context | 역할 | 구현 |
|---|---|---|
| 규칙 | 팀 코딩 규칙/금지사항 | CLAUDE.md |
| 지식 | 사내 API 정확한 사용법 | Skills (hmeg-api RAG) |
| 패턴 | 기존 동작하는 코드 구조 | examples/ |
| 작업 | 기능 구현 구체적 지시 | PRPs/ |
구성 요소 5가지
CLAUDE.md
프로젝트 헌법. 세션 시작 시 자동 로드.
- 개발 명령어, 필수 규칙, 프로젝트 구조
- 규칙 예: HmEG 객체
using필수 /try-catch필수 / 이모지 금지
Commands (.claude/commands/)
슬래시 명령어로 호출하는 표준 프롬프트.
/generate-prp: 기능 요청 → PRP 설계서 생성/execute-prp: PRP → 실제 코드 구현 (hmeg-api 자동 호출)
Subagents (.claude/agents/)
전문 역할의 자율 AI 서브프로세스.
validation-gates: 빌드/테스트 자동 검증 (가장 핵심)architecture-manager: PlantUML 다이어그램 생성code-analyst: 기존 코드 패턴 분석
Skills (.claude/skills/hmeg-api/)
외부 도구 연동. Google Gemini RAG로 HmEG 문서 검색.
- HmEG.md → 벡터 스토어 업로드 → 의미론적 검색
- 실제 API 시그니처 + Citation 제공 → 할루시네이션 방지
Hooks (.claude/hooks/)
생명주기 이벤트에 결정론적으로 실행되는 쉘 스크립트.
PreToolUse: 위험 명령(rm .env등) 차단PostToolUse: 파일 편집 후 자동 로그
개발 워크플로우
INITIAL.md 작성
↓
/generate-prp → PRPs/feature_prp.md (API 조회 마커 포함)
↓
검토/수정
↓
/execute-prp → hmeg-api Skill 호출 → 코드 구현
↓
validation-gates → dotnet build (Warning 0) / dotnet test
↓
완료
PRPs / examples
PRPs: AI가 첫 시도에 올바른 코드를 생성하기 위한 구조화된 작업 지시서
[API 조회 필요: ClassName]마커로 할루시네이션 방지- 구현 단계 + 검증 게이트 + 위험 완화 포함
examples/: AI의 코드 패턴 학습 자료
snippets/: 단일 API 사용 최소 예제 (AddBox.cs 등)EGViewportSample/: 완전한 MVVM 구현 참조