AI 도서관 · Gemini · 하네스 설정 · AI 갈아타기

AGENTS.md — Gemini CLI도 읽는 공용 규칙

도구에 안 묶이는 공용 규칙 파일. 단 Gemini CLI는 설정을 한 줄 넣어야 읽어요

내용

📌 AGENTS.md = 저장소 루트에 두는 도구 중립 규칙 파일

• 2025년 8월 OpenAI 공개 → 2025년 말 리눅스 재단 Agentic AI Foundation 으로 이관
• 2026년 5월 기준 170개 이상 기관, 6만 개 이상 저장소 채택

⚠️ Gemini CLI 는 그냥 두면 안 읽습니다
기본 파일 이름이 GEMINI.md 라서, AGENTS.md 를 쓰려면 settings.json 에 지정해야 합니다.

   "context": { "fileName": ["AGENTS.md", "GEMINI.md"] }

이 한 줄이 빠지면 파일을 잘 써놔도 통째로 무시됩니다.

[ 담는 내용 ]
• 빌드·테스트 명령 (옵션까지)
• 기본값과 다른 스타일 규칙
• 구조적 제약과 건드리면 안 되는 경계

💡 도구를 옮겨도 이 파일은 그대로 유효합니다.
다만 도구마다 '어떻게 읽게 만드는지'는 한 번씩 확인해야 합니다.

📅 2026년 9월 확인

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
Gemini CLI 는 기본 파일명이 GEMINI.md — AGENTS.md 를 읽게 하려면 settings.json 에서 context.fileName 을 지정해야 함
주의
'그냥 두면 알아서 읽는다'가 아닙니다. 설정 한 줄이 빠지면 파일이 무시됩니다.
공식 출처
https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/gemini-md.md
확인일
2026-09-08 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기