01-카탈로그-13개

01. 카탈로그 — 13개 안티패턴

각 항목 형식: AP-NN. 이름 — 증상 / 원인 / 치료 / 관련 챕터

---

AP-01. 부사 품질 요구(Adverb-Quality)

• 증상: 프롬프트에 “잘”, “깔끔하게”, “임팩트 있게” 같은 부사가 등장
• 원인: 명확성 부족. 측정 불가능한 단어
• 치료: 출력 형식·금지·예시로 풀어 적기
• 관련: 4/01 명확성

AP-02. 맥락 누락(Context-Free Order)

• 증상: “리뷰해 줘”, “요약해 줘”만 던지고 도메인·우선순위·독자 정보 없음
• 원인: “Claude는 신입사원” 비유를 잊음
• 치료: Why-맥락(왜) + What-맥락(스키마/컨벤션) 한 단락
• 관련: 4/01 맥락

AP-03. 예시 0개 형식 강제(Schema-Only Format)

• 증상: “JSON으로 답하라”만 적고 예시 없음. 코드블록 감싸짐, 산문 서론 등으로 깨짐
• 원인: 형식 강제의 가장 약한 기법 하나에만 의존
• 치료: 스키마 + few-shot + assistant prefill + (가능하면) tool use
• 관련: 4/03 형식 강제

AP-04. 시스템·사용자 혼합(Layer-Mixing)

• 증상: 매 호출마다 역할·정책을 다시 적음. CLAUDE.md에 일회용 지시
• 원인: 두 층의 변동성 위계를 모름
• 치료: 변하지 않는 것 → 시스템 / 변하는 것 → 사용자
• 관련: 4/02

AP-05. 인젝션 무방비(Injection-Open)

• 증상: 외부 입력(이메일·웹 본문)을 시스템과 한 덩어리로 합침
• 원인: 신뢰 경계 부재
• 치료: <untrusted> 같은 태그로 격리, 시스템 정책을 단단히
• 관련: 4/02

AP-06. 사고·답 혼합(CoT-Bleed)

• 증상: 사고 사슬과 최종 답이 한 덩어리로 출력. 호출자 파싱 깨짐
• 원인: <thinking> / <answer> 분리 없음
• 치료: 태그 분리 또는 extended thinking 채널 사용
• 관련: 4/04

AP-07. CoT 남용(CoT-Everywhere)

• 증상: 분류·추출 같은 단순 작업에 “단계별로 사고하라”
• 원인: CoT가 공짜라고 착각
• 치료: 작업 난이도와 비용 맞추기
• 관련: 4/04

AP-08. Plan-Mode 우회(Auto-Approve)

• 증상: Plan-Mode가 켜져 있지만 승인이 자동화됨
• 원인: 사람 게이트의 의미를 잊음
• 치료: 부작용이 비가역적인 작업은 사람 손으로 승인
• 관련: 4/04

AP-09. 평가 부재(No-Eval Tuning)

• 증상: “느낌상 좋아진 것 같다”로 머지
• 원인: 회귀 세트 없음
• 치료: evals/ 디렉토리 + metrics.yml + CI 차단
• 관련: 4/05

AP-10. 평균의 함정(Average-Trap)

• 증상: 전체 정확도만 보고 머지. 운영에서 특정 슬라이스가 깨짐
• 원인: 슬라이스별 분리 없음
• 치료: 카테고리·언어·길이별 분리 측정
• 관련: 4/05

AP-11. 자기 검증(Self-Judge)

• 증상: 같은 모델·같은 sub-agent가 자기 출력을 채점하고 published
• 원인: 분리 패스 부재
• 치료: writer ≠ reviewer ≠ verifier. 가능하면 다른 모델
• 관련: 4/05, CLAUDE.md §10

AP-12. 모순 정책(Conflicting Rules)

• 증상: 시스템 안에 “한국어로”와 “영문 유지”가 우선순위 없이 충돌. 모델이 둘 다 무시
• 원인: 정책 누적 없이 가지치기 부재
• 치료: 5원칙 체크리스트로 주기적 정리, 우선순위 명시
• 관련: 4/01, 4/02

AP-13. 무한 누적(Prompt-Bloat)

• 증상: “이것도 추가, 저것도 추가”를 반복해 시스템이 1000줄. 자가 모순. 캐시 효율 저하
• 원인: 평가 없이 추가만, 제거 없음
• 치료: 변경마다 회귀 세트로 효과 측정. 효과 없는 줄은 즉시 삭제
• 관련: 4/05

---

빠른 표

ID	이름	깨진 원칙	치료 챕터
AP-01	Adverb-Quality	명확성	4/01
AP-02	Context-Free Order	맥락	4/01
AP-03	Schema-Only Format	예시·구조	4/03
AP-04	Layer-Mixing	구조	4/02
AP-05	Injection-Open	안전	4/02
AP-06	CoT-Bleed	구조	4/04
AP-07	CoT-Everywhere	비용 균형	4/04
AP-08	Auto-Approve	안전	4/04
AP-09	No-Eval Tuning	평가	4/05
AP-10	Average-Trap	평가	4/05
AP-11	Self-Judge	평가	4/05
AP-12	Conflicting Rules	명확성	4/01
AP-13	Prompt-Bloat	평가	4/05