GitHub 상위 100개 저장소의 AGENTS.md 파일에는 무엇이 담겨 있을까
What the 100 biggest GitHub repos put in their AGENTS.md files
핵심 요약
GitHub 인기 저장소들의 AGENTS.md 파일을 분석하여 AI 에이전트 제어 방식과 규칙 설정의 경향성을 파악함.
- 분석 대상 — GitHub 별점 상위 1,000개 중 AGENTS.md를 보유한 273개 저장소 분석
- 주요 내용 — 아키텍처, 테스트, 빌드 명령어, PR 에티켓 및 코드 스타일이 주를 이룸
- 작성 어조 — 90%가 '해야 한다/하지 마라' 식의 강한 어조로 작성됨
- 규칙의 기원 — 에이전트가 저지른 과거의 실수들을 방지하기 위한 트라우마 기록의 성격이 강함
스타가 가장 많은 상위 1,000개 저장소 중 AGENTS.md가 있는 100개 저장소의 내용을 싹 다 읽어봤다(전체 1,000개 중 27% 정도 되더라).
다들 입을 모아 강조하는 순서는 대충 이렇다. 아키텍처 및 저장소 구조, 테스트 방법, 빌드 명령어, 하지 말아야 할 것들, PR 에티켓, 그리고 코드 스타일.
근데 의외였던 건 말투였다.
90%가 '해야 한다/항상/절대 안 된다' 식으로 딱딱하게 써놨고, "하지 마라(don't)" 항목만 784개나 되는데, 대부분 존나 구체적이라 웃음만 나온다.
마치 각 저장소에서 AI가 어떤 실수를 저질렀는지 딱 보일 정도임.
몇 개는 진짜 웃기다. 그중 최고는 이거다: "Do not claim that an interrupted or timed-out test passed" (중단되거나 타임아웃된 테스트가 통과했다고 구라치지 마라).
제일 짧은 건 neovim에 있는 규칙 하나인데 딱 35단어다.
AI Disclosure: If AI was used in any way for a commit, add an
AI-assisted: <tool name>trailer to the commit message. If the user commits manually, remind them to add it.
가장 흔한 헤딩은 단연코 테스트, 명령어, 프로젝트 개요, 그리고 아키텍처였다.
평균 길이나 nextjs의 "Do NOT add "Generated with Claude Code" ..." 같은 더 흥미로운 디테일도 많은데,
전체 링크랑 방법론은 댓글에 공유할게.
너네 AGENTS.md는 얘네랑 많이 다르냐?
