1. 프롬프트 엔지니어링은 반복 작업임. 한 번에 완성되는 게 아니라 돌려보고 틀린 부분 잡고 수정하는 피드백 루프가 핵심.

2. 좋은 프롬프트 구조는 순서가 있음. 역할 설명 → 데이터 → 단계별 지시 → 예시 → 마무리 강조. 이 순서 지키는 것만으로도 결과가 달라짐.

3. 고정 정보는 시스템 프롬프트에 넣어라. 매번 바뀌지 않는 양식, 배경 설명 같은 건 시스템 프롬프트에 한 번 박아두면 Claude가 매번 파악하는 데 토큰 낭비 안 함. 프롬프트 캐싱 쓰기도 좋음.

4. XML 태그로 정보를 구조화해라. Claude가 어느 태그 안에 뭐가 있는지 알면 나중에 참조할 때 훨씬 정확해짐.

5. 분석 순서를 명시해라. 스케치 먼저 보지 말고 신고서 먼저 보라는 식으로 순서를 지정해주면 Claude가 사람처럼 논리적으로 접근함.

6. 예시(Few-shot)가 생각보다 강력함. 판단이 애매한 케이스를 예시로 넣어두면 비슷한 상황에서 참고함. 이미지도 base64로 넣을 수 있음.

7. 확신 없으면 판단 금지 조건을 명시해라. 안 그러면 Claude가 그럴듯하게 추측해서 틀린 결론 냄.

8. 출력 포맷을 지정해라. XML 태그나 JSON으로 감싸서 출력하게 하면 downstream 파싱이 쉬워짐. Pre-fill로 응답 시작 형식을 고정하는 것도 방법.

9. Extended Thinking은 프롬프트 개선 도구로 써라. Claude 사고 과정이 노출되니까 어디서 틀리는지 파악하고 시스템 프롬프트 개선하는 데 활용할 수 있음

1. Vscode 내에서 별도의 마스터세션 생성, 규칙 문서 + 진행 문서 + 세션 분리 + 자동화 시킴

2. 복잡한 작업일경우 마스터세션 에서 오케스트레이션, 하위 세션을 생성하고 프롬프팅 전달하는 방식

3. 항상 진행상황은 PROGRESS.md 같은 파일에 아카이브 하도록 지시

4. Vscode에서 작업한 일은 텔레그램 알림으로 진행상황 알림 (저는 봉비스 봇을 만들어서 쓰고 있음)

5. 새로 발견한 패턴들은 규칙 문서에 추가하도록 지시

# [프로젝트명] — AI 작업 규칙 (CLAUDE.md)

## 역할
너는 [내 ○○ 담당]이다. [무엇을 하는지 한 줄].

## 자동 행동 (말 안 해도)
- 의미 있는 진전마다 PROGRESS.md 갱신
- 확신 없으면 추측 금지 → "모름/미확인" 표기
- [민감 파일/금지 행동] 절대 X

## 자연어 트리거 (한마디 = 정해진 행동)
- "커밋해" → [내 커밋 규칙]대로 정리 + 푸시
- "이어서" → PROGRESS.md 읽고 맥락 복원 후 진행
- "정리해" → 오늘 한 일 PROGRESS.md에 5줄 요약

## 문서 체계 (컨텍스트 영속화)
- PROGRESS.md : 지금 어디까지 (목표/결정/진행/할일/막힌거)
- DEFERRED.md : "나중에" 미뤄둔 것 추적

## 톤
[반말/존댓말, 길이, 피해야 할 표현]

1. 세션 시작 — 컨텍스트 복원 + 자율 진행:
PROGRESS.md + CLAUDE.md 읽고 이어서 진행해줘.
오늘 목표는 [X]. 거기까지 자율로 가되,
막히면 멈추지 말고 기록하고 넘어가.
끝나거나 막히면 [알림 채널]로 알려줘.

2. 진화 — 패턴을 시스템에 박기:
방금 우리가 [반복한 작업/내린 결정] 있잖아.
이거 앞으로 자동으로 되게 CLAUDE.md 규칙에 추가해줘.
다음부턴 내가 한마디만 해도 작동하게.