좋은 AGENTS.md를 쓰는 방법
좋은 AGENTS.md는 프롬프트 덤프가 아닙니다. 실제 저장소 안에서 작업하는 에이전트를 위한 짧고 명확한 실행 규약입니다.
좋은 파일은 목적, 핵심 제약 사항, 검증 명령, Git 워크플로, 코드베이스 핵심 구조를 구체적으로 설명합니다. 모호한 문구와 군더더기는 피합니다.
좋은 AGENTS.md의 원칙
- 프로젝트가 무엇을 하는지 한 문장으로 적습니다.
- 에이전트가 절대 도입하면 안 되는 동작을 적습니다.
- install, lint, typecheck, test, build 명령이 있으면 정확히 적습니다.
- 라우트, 로직, 콘텐츠, 공용 UI가 어디에 있어야 하는지 설명합니다.
- 문구는 명령형으로, 빠르게 스캔할 수 있게 유지합니다.
빌더 프리셋은 빈 화면에서 시작하지 않고 중요한 부분만 수정할 수 있게 탄탄한 기본값을 제공합니다. 생성된 예시를 먼저 보고 싶다면 예시 페이지.
가이드 FAQ
좋은 AGENTS.md에는 무엇이 들어가야 하나요?
좋은 AGENTS.md는 프로젝트 목적, 핵심 제약 사항, 설정 및 검증 명령, 코드 규칙, 안전 규칙, Git 워크플로 규칙, 아키텍처 메모를 설명합니다.
빈 편집기 대신 프리셋을 쓰는 이유는 무엇인가요?
프리셋은 누락을 줄여 줍니다. 현실적인 명령, 금지 사항, 스택별 가이드를 미리 채워 두기 때문에 빈 화면에서 시작하지 않아도 됩니다.
lint 패널이 모호한 문구를 경고하는 이유는?
"알아서 처리" 같은 표현은 코딩 에이전트를 실제로 제약하지 못합니다. 짧고 명령형인 지시가 에이전트가 일관되게 따르기 쉽습니다.