[바이브 코딩] AGENTS.md 로 코딩 에이전트 활용하기

바이브 코딩

💡AGENTS.md

• OpenAI Codex 팀에서 처음 발표한 AI 에이전트 용 표준 규칙 파일
• 프로젝트에서 AI 에이전트에게 필요한 맥락과 지침을 주입시켜주는 간단한 마크다운 파일

💡AI 에이전트가 뭐지? (참고 자료)

• 단순히 답하는 AI가 아니라 실제 작업을 스스로 수행하고 끝까지 완료하는 실행형 AI 시스템

---

효율적인 AGENTS.md 구조

💡하나의 AGENTS.md는 500줄 이내로 유지

• LLM 모델의 특성상 컨텍스트 윈도우 사이즈가 한정되어 있기 때문에 에이전트 규칙이 차지하는 정의 때문에 컨텍스트 낭비가 생길 수 있다.

❓컨텍스트
LLM이 쓸 수 있는 제한된 공간

❓LLM
자연어를 토큰과 숫자(벡터)로 변환한 뒤, 이전 문맥을 기반으로 다음에 올 ‘단어(토큰)’의 확률을 계산해 생성하는 모델
ex. 나는 밥을 먹었다. (자연어) -> 나는 / 밥을 / 먹었다. (토큰) -> 숫자 (벡터)로 변환 -> 나는 밥을 ___. 에서 먹었다를 예측

❓컨텍스트 원도우 사이즈
LLM이 한 번에 읽고 기억할 수 있는 텍스트 용량의 한계

 

💡큰 프로젝트에서는 여러 개의 조합 가능한 작은 규칙으로 나누어 정의

• 여러 개의 중첩된 파일로 구조적으로 규칙 파일 정의

출처 : https://www.youtube.com/watch?v=LHx_EFoLonQ

 

💡AGENTS.md 파일도 소스코드와 함께 버전관리 하기

• 코드가 변경되었을 때, 관련된 AGENTS.md 파일도 함께 수정하여 버전 관리를 코드와 같이 해주는 것을 권장

❓버전 관리
파일의 변화 과정을 시간순으로 저장하고 관리하는 것

• AI 에이전트가 실제로 코드를 생성하고 작업할 때 AGENTS.md 파일이 큰 영향을 미치기 때문에 코드 리뷰에서 코드만 리뷰하는 것이 아닌, AGENTS.md 파일도 함께 리뷰 하는 것을 권장

💡신규 팀원 온보딩에 AGENTS.md 활용하기

• AGENTS.md 파일에는 아래와 같은 여러 가지 정보가 포함되어 있기 때문에 프로젝트의 코드베이스를 굉장히 빠르게 파악하고 작업을 시작할 수 있는 역할을 할 수 있다.

출처 : https://www.youtube.com/watch?v=LHx_EFoLonQ

 

💡한 번 작성으로 끝나는 것이 아니라 계속해서 반복적으로 개선하기

• 프로젝트 구조 변경, 새로운 기술 스택 추가, 정해진 규칙 준수 여부를 지속적으로 모니터링하고 업데이트 하는 것이 필요하다.

---

읽어 보기

1. 컬리 기술 블로그 : https://helloworld.kurly.com/blog/vibe-coding-with-claude-code/

Claude Code를 활용한 예측 가능한 바이브 코딩 전략

---

참고 자료

1) 유튜브 - 개발동생 : 코딩 에이전트 성능을 20배 올리는 가장 쉬운 방법 | AGENTS.md로 표준 규칙 파일 정의하기

https://www.youtube.com/watch?v=LHx_EFoLonQ