ONEDEV

agents-md

ferroxlabs파일 3개

★ 694주당 +9조회 2

무엇인가

agents-md는 저장소 루트에 AGENTS.md 한 파일을 두어 코딩 에이전트의 작업 태도를 시니어 엔지니어 기준으로 고정하는 규칙 파일이다. 아첨성 응답, 요청 범위를 벗어난 즉흥 리팩터링, 검증 없는 완료 선언이라는 세 가지 실패 모드를 규율 대상으로 삼는다.

어떻게 동작하나

파일은 0~9번 행동 규범 섹션, 10번 프로젝트 컨텍스트, 11번 프로젝트 학습 기록으로 나뉜다. 0~9번은 손대지 않고, 10번에는 스택·빌드/테스트/린트 명령·소스 및 테스트 디렉터리 배치를 TODO 자리에 채운다. 11번은 빈 상태로 시작해 에이전트가 교정받을 때마다 한 줄씩 스스로 추가한다. 에이전트는 세션 시작 시 이 파일을 자동으로 읽으며 별도 훅이나 슬래시 명령 등록은 필요 없다.

무엇과 다른가

프롬프트에 규칙을 직접 붙여 넣는 방식과 달리 저장소에 커밋되어 세션마다 재사용된다. CLAUDE.md 단독 운용과 달리 AGENTS.md를 단일 원본으로 두고 CLAUDE.md·GEMINI.md를 심링크해 도구별 규칙 파일을 중복 관리하지 않는다. 규칙을 도구별로 쪼개는 대신 크로스툴 표준 파일 하나를 공유한다는 점이 구조적 차이다.

어떻게 쓰나

설치는 파일을 받아 루트에 두고, Claude Code와 Gemini CLI가 자기 파일명을 찾는 경우에만 심링크를 건다. 에이전트에게 설치를 위임할 때는 기존 AGENTS.md가 있으면 덮어쓰기 전에 diff를 보여주고, CLAUDE.md·GEMINI.md에 내용이 있으면 지우지 말고 첫 줄에 @AGENTS.md를 추가하도록 지시한다. 설치 후 세션을 재시작해야 파일이 로드된다.

전제와 한계

AGENTS.md를 네이티브로 읽는 Codex·Cursor·Aider·Windsurf·Copilot·Devin 등에서는 추가 설정이 없고, Claude Code와 Gemini CLI는 심링크가 실패하면 복사로 대체하며 갱신 시 재복사가 필요하다. 11번 섹션은 설계상 비워 두는 영역이라 초기 설치 단계에서 채우지 않는다. 대형 코드베이스에서 파일이 커질 때만 Claude Code의 @import나 .claude/rules/*.md, Cursor의 .cursor/rules/*.mdc로 분할하는 것을 검토한다.

관련 논문 2

유사 스킬