Vercel Next.js 팀의 개발자가 약 60B tokens를 소모하며 정리한 AGENTS.md에는 핵심적인 8가지 규칙이 담겨 있습니다.

60B tokens가 어느 정도의 규모냐고요? 대략 수십만 달러(six-figure USD)에 달하는 가치입니다.

이 8가지 규칙의 본질은 한 문장으로 요약됩니다: 당신의 AI 프로그래밍 Agent가 모든 것을 스스로 만들려고 하는 인턴처럼 행동하지 않게 만드는 것입니다.

바로 규칙을 공개합니다:

1. 하위 호환성(Backward Compatibility)을 유지하지 마세요. 오래된 것은 즉시 삭제하고, 호환 계층을 추가하거나, 마이그레이션(Migration)을 작성하거나, 폴백(Fallback)을 남겨두지 마세요.

2. 현재 요구사항을 충족할 수 있는 가장 단순한 구현을 선택하세요. 예방적 추상화(Preventative Abstraction)나 불필요한 설정 계층을 만들지 마세요.

3. 시스템 계층을 길게 가져가세요. 먼저 최소한의 엔드 투 엔드(End-to-End) 버전을 실행시킨 다음, 그 위에 기능을 추가하세요. 미완성된 복잡성 때문에 실행 가능한 것을 허물지 마세요.

4. 컴포넌트는 모듈화(Modular)를 유지하고 관심사 분리(Separation of Concerns)에 집중하세요.

5. 성숙하고 유지보수되고 있는 라이브러리를 우선적으로 사용하세요. 명확한 이유가 없다면 직접 다시 작성하지 마세요.

6. 새로운 패키지를 추가하거나 직접 작성하기 전에, 프로젝트 내에 이미 있는 의존성(Dependency)으로 무엇을 할 수 있는지 먼저 살펴보세요. 라이브러리에 없을 것이라고 성급하게 가정하지 마세요.

7. 아키텍처 결정은 장기적인 관점에서 하세요. "일단 이렇게 하고 나중에 바꾸자" 식의 임시 방편은 허용하지 않습니다.

8. 성숙한 제품이 동일한 문제를 어떻게 해결하는지 먼저 확인하고, 검증된 패턴을 사용하세요. 처음부터 새로 발명하지 마세요.

이 8가지 규칙을 프로젝트 루트 디렉토리의 AGENTS.md에 넣어두면, Cursor, Claude Code, Codex, Windsurf가 모두 자동으로 읽어 들입니다.

왜 이것이 토큰을 아껴줄까요? AI가 코드를 작성할 때 가장 큰 낭비는 코드를 틀리는 것이 아니라, 중복해서 작성하는 것이기 때문입니다.

표준 라이브러리로 10줄이면 끝날 일을 해결하기 위해 AI가 세 개의 의존성을 가져오고 다섯 개의 추상 계층을 만든다면, 당신이 수정을 요청할 때 AI는 다시 200줄을 작성하게 됩니다.

이 8가지 규칙은 AI가 펜을 들기 전에 먼저 제어하는 역할을 합니다: 쓰지 않아도 될 것은 쓰지 않고, 재사용할 수 있는 것은 재사용하며, 단순할 수 있는 것은 복잡하게 만들지 않도록 말이죠.

코드가 짧아지고 재작업이 줄어들면, 토큰은 자연스럽게 절약됩니다.

이전에 추천했던 Ponytail 플러그인도 같은 일을 수행하지만, 그것은 런타임(Runtime)에서 강제로 검사하는 방식인 반면, 이 방식은 AGENTS.md를 통해 근본적으로 제약하는 방식입니다. 두 가지를 함께 사용하면 효과가 매우 뛰어납니다.

하지만 저자는 매우 중요한 경고를 덧붙였습니다:

이 방식은 사이드 프로젝트(Side Projects)에만 적합하며, 운영 환경(Production Environment)에서는 주의해서 사용해야 합니다.

그는 직접 말했습니다. "하위 호환성을 유지하지 마라"는 규칙 때문에 Agent가 운영 데이터베이스의 테이블을 삭제할 뻔했으며, 2,000달러 상당의 데이터를 잃을 뻔했다고 합니다. 운영 환경에서는 직접 수정해야 하며, 최소한 첫 번째 규칙을 삭제하거나 좀 더 완화된 방식으로 바꿔야 합니다.

따라서 사이드 프로젝트, 내부 도구, 프로토타입을 만들고 있다면 이 8가지 규칙을 AGENTS.md에 복사해 넣으세요. AI가 작성하는 코드가 갑자기 사람처럼 느껴질 것입니다.

만약 운영 환경에서 사용한다면, 첫 번째 규칙과 일곱 번째 규칙 사이의 균형을 스스로 잘 조절하여 AI가 당신의 데이터베이스 테이블을 삭제하지 않도록 주의하세요.

토큰을 아끼는 방법은 많습니다. 더 저렴한 모델로 바꾸는 방법도 있고, 프롬프트(Prompt)를 잘 쓰는 방법도 있습니다. 하지만 가장 효과적인 방법은 프로젝트 루트 디렉토리에 파일을 하나 두고 AI에게 이렇게 말하는 것입니다:

"불필요한 기교 부리지 말고, 실행 가능한 최소한의 코드만 작성해."