Agents.md로 AI 코딩 도구에게 팀 컨벤션 알려주기

AI 코딩 도구를 쓰다 보면 처음에는 꽤 놀랍습니다. 요구사항을 말하면 컴포넌트도 만들고, 테스트도 작성하고, 리팩터링 방향도 제안합니다. 그런데 실무 프로젝트에 조금만 깊게 들어가면 곧 이런 문제가 생깁니다.우리 팀의 폴더 구조를 자꾸 무시한다.테스트 실행 방법을 매번 다시 알려줘야 한다.사용하지 않는 라이브러리나 패턴을 제안한다.작은 수정인데도 너무 넓은 범위를 바꾼다.PR에서 리뷰어가 싫어하는 스타일을 반복한다.이 문제는 AI 성능만의 문제가 아닙니다. AI에게 프로젝트의 기준과 맥락을 전달하는 방식이 아직 정리되지 않았기 때문에 생기는 문제에 가깝습니다. 최근 글에서 다룬 Spec-Driven Development가 “무엇을 만들지”를 명확히 하는 접근이라면, Agents.md는 “이 프로젝트에서..

2026.05.28