AI 코딩 에이전트에게 프로젝트 규칙을 기억시키는 법(AGENTS.md와 CLAUDE.md)
AI 에이전트 운영 파일 가이드 · 2026년 7월 기준 AI에게 매번 “이 프로젝트는 pnpm을 쓰고, 생성 파일은 직접 수정하지 말고, 작업이 끝나면 테스트를 실행해”라고 설명하고 있다면 문제는 모델 성능보다 프로젝트의 암묵지가 저장소에 없다는 것일 수 있다. 대화창의 지시는 세션이 바뀌면 사라지기 쉽다. 반면 AGENTS.md와 CLAUDE.md는 빌드 명령, 코드 규칙, 금지사항, 완료 기준을 프로젝트와 함께 버전 관리할 수 있게 해준다. 다만 두 파일은 이름만 다른 같은 기능이 아니다. 자동으로 읽는 도구와 탐색 방식이 다르며, 이 차이를 무시하면 “분명 파일에 적었는데 왜 안 지키지?”라는 문제가 생긴다. 먼저 보는 핵심 결론 ① AGENTS.md는 여러 AI 코딩 도구가 채..