AGENTS.md 스니펫
AI 에이전트와 함께 코딩하는 방법에 대한 제 비디오에서 보여드린 대로, 저의 AGENTS.md / CLAUDE.md 파일에서 복사하여 붙여넣은 관례입니다:
이 내용은 AGENTS.md, CLAUDE.md 또는 이에 준하는 모든 에이전트 지침 파일에서 작동합니다. 자신의 환경에 맞게 문구를 조정하세요. 중요한 것은 아이디어입니다.
1. 컨텍스트 재진입 (context-switching 문제 해결)
여러 에이전트를 동시에 다룰 때, 에이전트가 제공하는 모든 요약은 당신에게 콜드 스타트(cold start)입니다. 이 블록은 에이전트들이 이를 위해 작성하도록 만듭니다. 이는 제가 사용하는 루트 지침 파일에 있으며, 모든 리포지토리에서 공유됩니다.
## Context re-entry (multi-project juggling)
I am juggling several projects, each with several concurrent sessions, and have usually lost
...
2. 병렬 에이전트를 위한 Git worktree
## Worktrees
When starting any new feature or fix, begin by creating a separate git worktree from the base
...
3. TDD는 필수입니다
이것은 자체 검증 루프(self-verification loop)입니다. 에이전트가 기능보다 먼저 테스트를 작성하면, 자신의 작업을 확인하고 당신에게 돌려주기 전에 스스로 실수를 고칠 수 있습니다.
## TDD is mandatory
Every change follows **failing test first → implement → verify**:
...
4. 실수 방지 게이트를 위한 빌더/드라이버 분리 (토큰 최적화)
이것은 라이브 세션에서 얻은 최적화입니다. 기능을 구축한(built) 에이전트는 거대한 컨텍스트(종종 150k–200k 토큰)를 가지고 있습니다. 만약 같은 에이전트가 리뷰 게이트(많은 턴의 모니터링과 간단한 응답을 필요로 함)를 구동한다면, 이 전체 컨텍스트가 매 턴마다 다시 전송됩니다. 대신, 빌더는 작업을 인계하고 신선하며 저렴하고 작은 컨텍스트를 가진 에이전트가 게이트를 구동합니다. 드라이버의 park→decide→resume 왕복은 약 30k 토큰을 소모하는 반면, 빌더는 약 200k 토큰을 소모합니다.
설정에 맞게 조정하세요. 제 것은 no-mistakes gate을 목표로 합니다.
## 게이트 오케스트레이션 (빌더/드라이버 분리)
- **빌더는 절대 게이트를 구동하지 않습니다.** 빌더 에이전트는 코드를 작성하고, 자신의 브랜치에 커밋하며, 작업을 종료합니다...
보너스 — 크로스 프로바이더 리뷰: 코드를 작성한 것과 다른 프로바이더가 검토하도록 하는 경우(예: Claude Code가 구현하고, Codex가 검토하거나 그 반대)는 버그의 다른 분포를 포착하며, 토큰 부하를 두 개의 구독에 분산시킵니다.
5. 사전 압축 (Pre-compact): 압축하기 전에 메모리 저장하기
세션의 컨텍스트가 커지면(1M 윈도우를 가진 모델에서도 약 200K 토큰 정도), 품질이 떨어지기 시작합니다. 이것이 바로 컨텍스트 로트(context rot)입니다. 해결책은 대화 내용을 짧은 요약으로 대체하는 '압축(compact)'이지만, 압축 단계는 파일을 작성할 수 없으므로 (결정 사항, 막다른 길, 마침내 작동한 명령어 등) 보존할 가치가 있는 모든 것은 먼저 저장하지 않으면 손실됩니다.
skills/precompact/SKILL.md는 제가 매번 압축하기 직전에 실행하는 스킬입니다. 이 스킬은 에이전트에게 전체 세션을 훑어보고 미래의 세션이 그렇지 않으면 다시 발견해야 할 내용을 저장하도록 지시한 다음, 자신이 작성한 내용을 보고하게 합니다.
- Claude Code:
~/.claude/skills/precompact/SKILL.md(모든 프로젝트) 또는 .claude/skills/precompact/SKILL.md(단일 프로젝트)로 저장한 다음, /precompact를 입력하고 완료될 때까지 기다린 후 /compact를 실행합니다.
- 다른 에이전트: 파일 내용을 사용자 지정 명령어 또는 저장된 프롬프트로 붙여넣거나, 압축하기 전에 에이전트에게 단순히 "skills/precompact/SKILL.md를 따르라(follow)"고 지시합니다.
컨텍스트 미터(Claude Code 또는 Codex의 상태 표시줄)에 주의를 기울여서 적절한 시기를 알도록 하세요.
비디오에서 언급된 도구들
- no-mistakes gate (Kun Chen 제공) — 코드에 도달하기 전에 자동화된 검토, 테스트 및 스크린샷 증거를 제공합니다.
- Grill Me skill (Matt Pocock 제공) — 에이전트가 모든 설계 결정 과정을 질문 하나하나로 인터뷰하게 만듭니다.
- Wispr Flow — 음성 인식(speech-to-text); 제 에이전트 프롬프트의 대부분은 구술로 작성됩니다.
추가 자료 (More)