지금 바로 이 문장 하나를 CLAUDE.md에 추가해야 합니다.

요약

연구원들은 LLM이 문서(CLAUDE.md 등)의 지침을 실제 코드베이스보다 우선시하는 구조적 결함을 발견했습니다. 이로 인해 에이전트가 구식 명령에 따라 작동하며 현재 코드를 무시할 수 있습니다. 이를 해결하기 위해, 문서 상단에 특정 프롬프트를 추가하여 코드 현실을 따르도록 유도해야 합니다.

핵심 포인트

• LLM은 '지침'으로 전달된 문서를 실제 코드보다 우선시하는 경향이 있음.
• Claude Code는 충돌 감지율이 높았으나, 문서의 구식 지침을 따르는 문제가 발생함.
• Codex는 기존 코드를 오래된 문서에 맞게 재작성하며 테스트를 망가뜨리는 심각한 문제를 보임.
• 해결책은 CLAUDE.md 상단에 '불일치 시 코드 규칙을 따르고 불일치를 지적하라'는 프롬프트를 추가하는 것.