anti-patterns
안티패턴 — RAG 망치는 법
섹션 제목: “안티패턴 — RAG 망치는 법”1. “전체 파일을 그냥 다 읽어줘”
섹션 제목: “1. “전체 파일을 그냥 다 읽어줘””Claude Code 초보가 가장 자주 빠지는 패턴. Grep → 부분 Read로 바꾼다.
2. 도구 32개 일괄 노출
섹션 제목: “2. 도구 32개 일괄 노출”46개에서 모델이 무너진다는 사실을 무시. 작업별 슬림화.
3. 임베딩만 쓰기 (또는 BM25만 쓰기)
섹션 제목: “3. 임베딩만 쓰기 (또는 BM25만 쓰기)”하이브리드가 거의 항상 낫다. 한 가지만 쓰는 건 평가 없는 선택.
4. 검색을 디버그하지 않고 프롬프트만 만지기
섹션 제목: “4. 검색을 디버그하지 않고 프롬프트만 만지기”Hamel의 원칙 위반. 검색 Recall이 0.4인데 프롬프트만 고친다 — 답이 컨텍스트에 없는데 어떻게 생성하나.
5. 검색 결과 그대로 인라인 (수십 KB)
섹션 제목: “5. 검색 결과 그대로 인라인 (수십 KB)”Context Pruning/Summarization 없이 raw 결과를 부모로. 토큰 폭주 + Context Confusion.
6. 단일 에이전트로 폭(breadth-first) 작업
섹션 제목: “6. 단일 에이전트로 폭(breadth-first) 작업”멀티 에이전트 +90.2% 사례를 무시.
7. 평가 데이터셋이 없는 RAG
섹션 제목: “7. 평가 데이터셋이 없는 RAG”“잘 되는 것 같은데?” 외에 측정이 없다. Recall@k조차 모른다.