grokbot-field-notes
무엇인가
에이전트 팀 운영에서 반복적으로 깨지는 지점을 규칙으로 고정한 문서 묶음이다. 역할 분리, 검증 절차, 오케스트레이션 순서, 프롬프트 문구, 실패 기록, 토큰 비용 산정까지를 각각 별도 파일로 나눠 다룬다. 코드 생성 자체보다 생성된 작업을 어떻게 검증하고 누가 어떤 권한을 갖는지를 규율 대상으로 삼는다.
어떻게 동작하나
실체는 마크다운 파일이다. 저장소 루트의 AGENTS.md가 기본 규칙 파일이고, agents/ 아래에 VERIFICATION.md(검증 루프), ORCHESTRATION.md(다중 에이전트 팀 설계), PROMPTS.md(효과가 확인된 문구)가 놓인다. Cursor용 규칙은 ports/cursor/rules/에 따로 있어 .cursor/rules/로 복사해 쓴다. .github/PULL_REQUEST_TEMPLATE.md는 PR에 검증 증거를 붙이도록 양식을 강제하고, roster/는 봇 역할 정의, playbooks/는 지원·세일즈 같은 직군별 절차, ANTIPATTERNS.md는 실패 패턴, reference/ECONOMICS.md와 reference/PRODUCT.md는 비용과 메모리·설명 경계 기준을 담는다. 훅이나 슬래시 명령은 없고, 에이전트가 컨텍스트로 읽어 따르는 방식이다.
무엇과 다른가
프롬프트를 매번 직접 쓰는 방식과 달리 규칙이 저장소에 파일로 남아 버전 관리되고 팀 단위로 공유된다. 단일 CLAUDE.md 한 장과도 다르다. 검증·오케스트레이션·프롬프트를 계층으로 분리하고, 실패 로그와 비용 참조를 같은 저장소에 두어 규칙 수정 근거를 남긴다. Cursor 전용 포트가 별도 디렉터리로 존재하는 것도 차이다.
어떻게 쓰나
설치는 루트에서 curl 한 줄로 AGENTS.md를 내려받는 것으로 끝난다. Cursor를 쓰면 ports/cursor/rules/의 파일을 .cursor/rules/로 복사하고, PR 증거 양식이 필요하면 .github/PULL_REQUEST_TEMPLATE.md를 해당 경로에 둔다. 에이전트 팀을 구성할 때는 agents/ORCHESTRATION.md를, 역할 정의가 필요하면 roster/README.md를, 직군별 절차는 playbooks/README.md를 먼저 읽는다.
전제와 한계
규칙은 마크다운 텍스트라 강제 실행 수단이 없다. AGENTS.md나 규칙 파일을 읽는 에이전트에서만 동작하며, Cursor 외 에이전트에서는 해당 포트를 그대로 쓸 수 없다. 마이그레이션·배포·금전·권한 변경에는 사람 승인 게이트를 두라는 전제가 문서에 명시되어 있고, 자동 검증이나 훅 기반 차단은 제공하지 않는다. 라이선스는 MIT다.