개발자 Rinidh가 Simple Orders Tracker 프로젝트를 리뷰하다가 발견한 문제인데요

AI 에이전트에게 준 지시 파일 한 줄이 프론트엔드 전체 아키텍처를 틀어버린 사례가 공개됐어요.

개발자 Rinidh가 Simple Orders Tracker 프로젝트를 리뷰하다가 발견한 문제인데요. AI가 집계 계산(총 매출, 총 주문, 미결 잔액)을 서버가 아닌 프론트엔드에서 처리하도록 구현해뒀던 거예요. 원인을 추적했더니 AGENTS.md에 적어둔 지시 한 줄이 AI를 그쪽 방향으로 유도하고 있었어요.

코드 리뷰만큼 AGENTS.md 리뷰도 꼼꼼하게 해야 한다는 교훈이에요. 작은 지시 하나가 쌓이면 의도와 전혀 다른 설계로 가있을 수 있거든요.