Drop-in AGENTS.md that makes every coding agent behave like a senior engineer instead of an eager intern. Kills sycophancy, stops drive-by refactors, forces verification loops. Synthesizes Karpathy's four principles and Boris Cherny's Claude Code workflow. Works with Claude Code, Codex, Gemini CLI, Cursor, and the open standard.
이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.
<p align="center"> <img src="https://github.com/FerroxLabs/agents-md/releases/download/v0.1.0/hero.png" alt="Sean Donahoe의 AGENTS.md — 코딩 에이전트를 위한 더 스마트한 운영 지침" width="100%"> </p>
하나의 파일. 모든 코딩 에이전트가 시니어 엔지니어처럼 행동하기 시작합니다.
아무 레포지토리에나 넣으세요. Claude Code, Codex, Cursor, Gemini CLI, Aider, Windsurf, Copilot, Devin 모두 자체적으로 읽습니다. 플러그인도, 설정도, 설치 의식도 필요 없습니다.
그냥 작동합니다.
이것은 Ferrox Labs에서 모든 프로젝트에 적용하는 도구이자 핵심 운영 규율입니다. 하나의 파일, 모든 에이전트, 모든 레포지토리.
프로젝트 루트에서 Claude Code, Codex, Cursor 또는 다른 코딩 에이전트를 열고 다음을 붙여넣으세요:
https://github.com/FerroxLabs/agents-md를 이 프로젝트에 설치하세요.
>
1.
https://raw.githubusercontent.com/FerroxLabs/agents-md/main/AGENTS.md를 가져와 프로젝트 루트에./AGENTS.md로 저장하세요.AGENTS.md가 이미 존재하면 중단하고 덮어쓰기 전에 diff를 보여주세요.2.
CLAUDE.md와GEMINI.md를AGENTS.md에 심볼릭 링크하여 Claude Code와 Gemini CLI가 같은 파일을 읽도록 하세요. OS에 맞는 명령어를 사용하세요(macOS/Linux는ln -s, Windows는New-Item -ItemType SymbolicLink). 심볼릭 링크가 실패하면 파일 복사로 대체하세요.CLAUDE.md나GEMINI.md가 이미 내용이 있으면 덮어쓰지 말고 첫 줄에@AGENTS.md를 추가하고 나머지는 그대로 두세요.3. 새
AGENTS.md를 열고 섹션 10(프로젝트 컨텍스트)을 찾아 이 코드베이스를 읽어 확인할 수 있는 것만 채우세요:package.json,pyproject.toml,Cargo.toml,Makefile의 스택, 빌드/테스트/린트 명령어, 소스/테스트 디렉토리 구조. 확인할 수 없는 것은TODO로 남겨두세요.4. 섹션 11은 건드리지 마세요 — 설계상 비어 있습니다.
5. 완료되면 파일이 로드되도록 이 세션을 다시 시작하라고 알려주세요.
세션을 다시 시작하세요. 끝입니다.
curl -o AGENTS.md https://raw.githubusercontent.com/FerroxLabs/agents-md/main/AGENTS.mdCodex, Cursor, Aider, Windsurf, Copilot, Devin, Amp, opencode, RooCode는 AGENTS.md를 자체적으로 읽습니다. 다른 작업은 필요 없습니다.
Claude Code와 Gemini CLI는 자신의 파일 이름을 찾으므로 심볼릭 링크가 필요합니다:
macOS / Linux
ln -s AGENTS.md CLAUDE.md
ln -s AGENTS.md GEMINI.mdWindows (PowerShell, 관리자 권한 또는 개발자 모드 켜서 실행)
New-Item -ItemType SymbolicLink -Path CLAUDE.md -Target AGENTS.md
New-Item -ItemType SymbolicLink -Path GEMINI.md -Target AGENTS.md심볼릭 링크를 사용할 수 없으면 대신 파일을 복사하세요 — AGENTS.md를 업데이트할 때 다시 복사해야 합니다:
Copy-Item AGENTS.md CLAUDE.md; Copy-Item AGENTS.md GEMINI.md세션을 여세요. 끝입니다.
| 이전 | 이후 | ||
|---|---|---|---|
| "당신 말이 완전히 맞아요!" → 작동하는 코드를 되돌림 | 에이전트가 당신이 틀렸을 때 반박함 | ||
| 50줄이면 될 것을 200줄 | 문제를 해결하는 가장 간단한 diff | ||
| 오타 수정하면서 전체 파일 재포맷 | 변경된 모든 줄이 요청에 기인함 | ||
| 실행되지 않는 코드에 "완료" 주장 | 먼저 검증을 작성하고, 실행한 후 보고함 | ||
| 두 가지 해석 사이에서 조용히 추측 | 모호함을 표면화하고 한 번 질문함 | ||
| 파일이 너무 길어서 절반 규칙 무시 | 간결하게 설계. 약 200줄. 규칙이 로드된 상태 유지 |
섹션 10 — 프로젝트 컨텍스트. 스택, 명령어, 레이아웃, 금지 영역. TODO를 한 번 채우세요. 5분.
섹션 11 — 프로젝트 학습. 비어 있는 상태로 시작합니다. 에이전트가 뭔가 잘못할 때마다 한 줄이 추가됩니다. 당신이 수정할 때 에이전트가 직접 줄을 추가합니다 — 파일을 관리할 필요가 없습니다.
이 섹션이 축적되는 부분입니다. Boris Cherny(Claude Code 창시자)는 팀 버전을 몇 달에 걸쳐 약 100개의 학습으로 운영합니다. 그의 파일은 선언문이 아니라 훈련된 반사 신경입니다.
섹션 0–9는 행동 프레임워크입니다. 특별한 이유가 없으면 건드리지 마세요.
드뭅니다. 하지만 대규모 코드베이스에서는 발생합니다. 샤딩하기 전에 문서를 읽으세요 — 대부분의 사람에게는 필요하지 않습니다:
CLAUDE.md 내에서 @path/to/file.md 임포트를 사용하거나, 주제별 규칙을 .claude/rules/*.md에 paths: 프론트매터와 함께 넣어 Claude가 일치하는 파일을 건드릴 때만 로드되도록 하세요. Claude Code는 자체적으로 메모리를 자동 기록합니다 — 다시 발명하지 마세요..cursor/rules/*.mdc를 경로 스코핑과 함께 사용하세요.AGENTS.md가 여전히 정답입니다.목표는 세션당 더 적은 토큰을 로드하는 것이지, 파일 자체를 늘리는 것이 아닙니다.
CLAUDE.md가 아니라 AGENTS.md인가AGENTS.md는 Linux Foundation의 Agentic AI Foundation이 관리하는 오픈 크로스툴 표준입니다. Codex, Cursor, Windsurf, Copilot, Aider, Devin, Amp, opencode, RooCode가 기본적으로 읽습니다. Claude Code는 CLAUDE.md를 읽습니다. Gemini CLI는 GEMINI.md를 읽습니다. 세 개를 모두 심볼릭 링크하면 모든 에이전트가 같은 파일을 읽습니다.
하나의 진실 공급원. 세 개를 유지할 필요가 없습니다.
MIT. 포크하고, 다시 쓰고, 자신의 이름으로 배포하세요. 그것이 요점입니다.
한 시간을 절약해 주었다면, 레포지토리에 ⭐을 주는 것이 감사 인사입니다.