실제로 작동하는 AGENTS.md 쓰는 법
모두가 추가하지만 두 번 읽지 않는 파일 AGENTS.md는 코딩 에이전트에게 저장소 안에서 어떻게 일할지 알려주는 표준으로 조용히 자리 잡았다. Codex가 읽고, Cursor와 Cline은 각자의 변형을 읽으며, agents.md 관례는 빠르게 퍼지고 있다. 그래서 팀들은 하나 추가한다 — 그리고 에이전트가 그 절반을 무시하는 걸 지켜본다. 문제는 에이전트가 지시를 못 따라서인 경우는 드물다. 대부분의 AGENTS.md가 새로 온 사람의 온보딩 문서처럼 쓰이기 때문이다: 프로젝트 소개, 배경 설명 문단들, 지향하는 가치. 이건 다음 턴에 모델이 하는 행동을 바꾸는 게 유일한 임무인 파일에는 정확히 잘못된 형태다. ...