AGENTS.md / CLAUDE.md 생성기 — 20+ 템플릿
Claude Code / Codex / Cursor / Windsurf / Gemini / GitHub Copilot을 위한 프로젝트 설정 파일을 20+ 개의 실용적인 템플릿 (Next.js / React / Vue / Django / FastAPI / Rails / Laravel / Go / Rust 등)에서 1클릭으로 생성합니다. AGENTS.md / CLAUDE.md / .cursor/rules/main.mdc / .windsurfrules / GEMINI.md / copilot-instructions.md의 6가지 형식 모두 지원, zip 일괄 다운로드.
▶ 📦 템플릿 선택 → 즉시 생성
▶ 🎛 운용 룰 팩 0 / 28
「본환경 건드리기 전에 허가 받아라」「출처를 반드시 제시하라」「진행 상황을 기록하라」등과 같은 AI 에이전트의 실무적 행동 규칙을 ON/OFF로 추가합니다. 출력 파일의 해당 섹션에 추가됩니다.
명령어
코딩 규약
안티 패턴
주요 파일
테스트
기타
📚 템플릿 목록
전체 24개 템플릿
📄 생성된 파일
AGENTS.md
📍 배치 위치
- AGENTS.md / CLAUDE.md / GEMINI.md → 저장소 root
- Cursor → .cursor/rules/main.mdc
- Windsurf → .windsurfrules (root)
- Copilot → .github/copilot-instructions.md
📖 자주 걸리는 지점
Claude Code / Codex / Cursor / Windsurf / Gemini / GitHub Copilot 용 프로젝트 설정 파일을 20 개 이상의 템플릿에서 생성합니다. AGENTS.md / CLAUDE.md / .cursor/rules/main.mdc / .windsurfrules / GEMINI.md / copilot-instructions.md 여섯 형식을 지원하며 zip 으로 한꺼번에 받을 수 있습니다. 처리는 브라우저 안에서 끝납니다. 다만 템플릿은 당신의 리포지터리를 모릅니다 — 그리고 잘못된 지시 파일은 없느니만 못한 결과를 낳습니다. 에이전트는 그것을 의심하지 않고 따르므로 사실과 다른 기술은 그대로 잘못된 구현이 되어 돌아옵니다.
| 사례 | 무슨 일이 일어나는가 | 어떻게 하면 되는가 |
|---|---|---|
| 템플릿 그대로 두면 사실이 아닌 것을 지시한다 | 생성된 뼈대에는 그 프로젝트에서는 옳지 않은 구체적인 기술이 포함됩니다 — npm test 로 테스트를 실행한다고 적혀 있는데 실제로는 pnpm 을 쓴다, 존재하지 않는 디렉터리 구성이 적혀 있다, 쓰지 않는 라이브러리의 규약이 늘어서 있다. 에이전트는 코드보다 지시 파일을 우선해서 믿습니다 — 그래서 「적혀 있는데 동작하지 않는」 명령을 몇 번이나 시도하고 실재하지 않는 곳에 파일을 만듭니다. 그리고 또 하나의 낭비가 「코드를 읽으면 알 수 있는 것을 쓰는」 일입니다 — 사용 프레임워크나 폴더 이름은 에이전트가 몇 초면 스스로 조사할 수 있습니다. 거기에 글자 수를 쓸수록 정말 필요한 정보가 옅어집니다. |
써야 할 것은 코드를 읽어도 알 수 없는 것뿐입니다. 구체적으로는 실제로 동작하는 명령 (테스트·빌드·배포·lint 의 정확한 한 줄), 과거에 밟은 함정과 그 이유, 건드리면 안 되는 곳과 그 이유, 여러 방식 중 이 프로젝트가 고른 방침. 「왜」를 쓰는 것이 가장 가치가 큽니다 — 이유를 알면 적혀 있지 않은 상황에서도 같은 판단을 할 수 있기 때문입니다. 만드는 방법으로는 템플릿을 토대로 삼지 말고 빈 파일에서 열 줄 쓰는 편이 더 나은 것이 됩니다. 그리고 가장 확실한 검증은 실제로 에이전트에게 작업을 시켜 지시대로 움직였는지를 보는 것입니다 — 틀림을 밟을 때마다 한 줄씩 더해 가는 것이 현실적인 키우는 법입니다. |
| 여섯 형식을 전부 출력해 전부가 어긋나 간다 | 도구마다 읽는 파일이 다르기 때문에 여러 도구를 함께 쓰는 팀에서는 같은 내용을 여러 곳에 두게 됩니다. 문제는 그것이 반드시 어긋나 간다는 점입니다 — 누군가가 CLAUDE.md 만 갱신하고 .cursor/rules 는 석 달 전 그대로인 상태가 되어 쓰는 도구에 따라 에이전트의 거동이 달라집니다. 게다가 어긋났다는 것을 알아챌 수단이 없습니다 — 양쪽 모두 구문적으로는 올바르고 CI 도 통과합니다. 읽히는 방식의 차이도 파악해 둘 필요가 있습니다: 항상 전문이 읽히는 것, 요청마다 일부만 참조되는 것, 리포지터리의 루트만 보는 것, 서브디렉터리 것도 읽는 것이 있고 이 차이는 「왜인지 이 도구만 지시를 무시한다」는 형태로 나타납니다. |
정본을 하나로 정하세요. 실무적으로는 AGENTS.md 를 정본으로 삼고 다른 형식은 그것을 참조만 하는 짧은 파일로 만드는 것이 다루기 쉬운 형태입니다 — CLAUDE.md 의 내용을 「AGENTS.md 를 읽을 것」 한 줄로만 해도 이중 관리는 사라집니다 (지원하는 도구라면 심볼릭 링크여도 상관없습니다). 모든 형식을 출력할 필요는 없습니다 — 실제로 쓰고 있는 도구의 것만 두세요. 그리고 정본은 리포지터리의 루트에 두고 반드시 Git 으로 관리하세요 — 개인의 설정 디렉터리에 두면 팀의 다른 구성원에게는 존재하지 않는 규칙이 됩니다. 리뷰 대상으로 삼으면 내용이 사실과 맞는지를 남이 확인할 수 있게 됩니다. |
| 길어질수록 듣지 않게 된다 | 지시 파일은 매번의 요청에서 컨텍스트를 소비합니다 — 500 줄의 규칙을 두면 그만큼 실제 코드를 읽을 여지가 줄어듭니다. 그리고 길수록 내부에서 모순되기 쉬워집니다: 「가장 단순한 구현을 우선」과 「반드시 추상화한다」가 같은 파일에 적혀 있으면 어느 쪽이 채택될지는 예측할 수 없습니다. 또 하나 흔한 것이 바람을 적어 버리는 것입니다 — 「반드시 테스트를 쓴다」고 적혀 있는데 리포지터리에 테스트가 하나도 없는 상태는 흔합니다. 이 모순은 에이전트를 혼란시킵니다 — 기존 코드를 따라야 할지 규칙을 따라야 할지 정할 수 없기 때문입니다. 그리고 지켜지지 않는 규칙은 다른 규칙의 신뢰성도 떨어뜨립니다. | 짧게, 구체적으로, 그리고 검증할 수 있는 형태로 쓰세요. 기준으로 한 화면에 담기는 길이부터 시작해 문제가 생겼을 때만 한 줄 더합니다 — 처음부터 망라하려 하면 반드시 쓰이지 않는 줄이 늘어납니다. 규칙은 「지켜지고 있는지를 확인할 수 있는」 것을 우선하세요: 「읽기 쉬운 코드를 쓴다」는 검증할 수 없지만 「src/legacy/ 는 변경하지 않는다」는 확인할 수 있습니다. 그리고 리포지터리가 실제로 지키지 않는 규칙은 삭제하세요 — 이상을 쓰고 싶다면 먼저 코드를 그 상태로 만든 뒤에 씁니다. 정기적인 재검토도 필요합니다: 빌드 명령이 바뀌었는데 파일이 예전 그대로면 에이전트는 매번 거기서 막힙니다 — 명령을 바꿨을 때는 같은 커밋에서 이 파일도 고치세요. |
이런 종류의 파일은 외부에서 읽힐 가능성을 전제로 쓰세요. 공개 리포지터리라면 누구나 읽을 수 있고 비공개라도 에이전트에게 넘긴 시점에 모델 제공처로 전송됩니다 — 내부 시스템의 호스트명, 인증의 구조, 아직 공개하지 않은 계획은 쓰지 마세요. 또 하나, 보안상의 성질로서 지시 파일은 「에이전트의 거동을 바꾸는 입력」입니다 — 제삼자가 PR 로 이 파일에 한 줄 더하면 이후 에이전트의 동작을 유도할 수 있습니다. 외부의 PR 을 머지하는 리포지터리에서는 이 여섯 종류 파일의 차분을 반드시 리뷰 대상으로 삼으세요 — 코드 변경보다 눈에 띄지 않는데 영향은 넓기 때문입니다. 마지막으로 운용 이야기를 하나: 이 파일은 쓰면 끝이 아니라 에이전트가 같은 실수를 반복했을 때 갱신하는 것입니다. 「왜인지 늘 같은 지적을 하고 있다」고 알아챘다면 그것이 이 파일에 써야 할 한 줄입니다.
📖 사용법
-
1
템플릿 선택20+ 프리셋에서 가장 가까운 것 클릭
-
2
필요시 미세조정"커스텀 편집"으로 프로젝트별 규칙 추가
-
3
형식 선택 + 다운로드개별 또는 zip 일괄
❓ 자주 묻는 질문
AGENTS.md와 CLAUDE.md 차이?
Cursor MDC란?
템플릿이 부족하면?
보안?
🐛 이 도구에서 문제가 발생했나요?
무료 · 가입 불필요. 재현 절차만이라도 도움이 됩니다. 보고는 운영자에게 직접 전달되어 개선에 사용됩니다.
보고 감사합니다!
운영자에게 전달되었습니다. 개선에 사용됩니다.