unicodef1wn/grokbot-field-notes

Rules, playbooks, bot roles and a failure log from the xAI Grok Bot team's 72-hour live build. Drop AGENTS.md into your repo and go.

Grok Bot Field Notes는 xAI Grok Bot 팀의 엔지니어 3명이 스턴트 빌드에서 추출한 파일, 템플릿, 플레이북의 공개 컬렉션입니다. 그들은 빈 저장소에서 시작하여 라이브 스트리밍 중에 자체 에이전트 플랫폼을 사용하여 72시간 만에 제품을 출시했습니다. 이 저장소는 해당 실행의 정수를 기록한 것으로, 누구나 규칙을 자신의 코딩 에이전트에 복사할 수 있도록 패키징되어 있습니다.

제작자. xAI Grok Bot 팀의 엔지니어 3명: Roshan Sadanani(제품), Lauren Tan(엔지니어링), Matt Palmer(개발자 경험). 저장소 자체에는 "내가 그 3일 동안 추출한 것"이라고 적혀 있으며, README에는 누가 추출 작업을 수행했는지 명시되어 있지 않지만 개인의 정리 결과물입니다.

내용. 몇 가지 범주로 나뉜 문서 세트:

  • 자체 에이전트를 위한 규칙. AGENTS.md는 내부 규칙이 담긴 단일 파일입니다. 이를 저장소 루트에 복사하면 저장소를 읽는 모든 코딩 에이전트가 해당 규칙을 적용합니다. ANTIPATTERNS.md는 라이브 빌드 중에 발생한 40가지 장애를 나열하며, 각 항목에는 무엇이 고장 났는지, 왜 고장 났는지, 그리고 그로부터 도출된 규칙이 설명되어 있습니다.
  • 컴포넌트 라이브러리. agents/에는 AGENTS.md가 참조하는 긴 참조 파일(검증, 오케스트레이션, 프롬프트)이 들어 있습니다. roster/에는 69개의 에이전트 역할이 있으며, 역할당 하나의 파일로 구성되어 각 역할의 책임 범위, 비책임 범위, 사실 출처, 승인 필요 사항, 붙여넣기 가능한 설명이 기술되어 있습니다. playbooks/에는 9개의 역할 워크숍(엔지니어링, PM, 창업자, 영업 엔지니어링, 영업, SDR, 지원, 사후 관리, 마케팅)이 있으며, 봇 팀, 워크플로우, 프롬프트, 수치가 포함되어 있습니다. ports/는 명단을 Cursor 전용 규칙 파일로 변환합니다.
  • 가이드 및 참조. guide/에는 두 개의 PDF가 포함되어 있습니다: 24페이지 분량의 Grok Bot Guide by SpaceX Engineers(3일간의 이야기, 멘탈 모델, 장애 로그, 경제성)와 14페이지 분량의 Grok Bot Marketing Guide(6개 봇에 걸친 캠페인 실행, 출시일 성장, 배포). reference/에는 두 개의 짧은 파일이 있습니다: ECONOMICS.md(모든 비용과 지표, 그리고 이를 뒷받침하는 규칙)와 PRODUCT.md(어떤 Grok Bot 기능이 봇 설계에 영향을 미치는지). notes/에는 모든 주장을 뒷받침하는 구조화된 일일 메모가 있습니다.
  • 워크플로우 도우미. .github/에는 검증 루프를 양식으로 바꾸는 풀 리퀘스트 템플릿이 포함되어 있습니다: 재현됨, 증명 첨부됨, 범위, 사람의 승인 필요. README는 "마이그레이션, 배포, 자금 및 권한"을 에이전트 루프가 아무리 잘 작동하더라도 사람이 게이트를 유지해야 하는 작업으로 명시하고 있습니다.

핵심 철학. README의 한 단락 요약이 운영 원칙을 포착합니다: 각 에이전트에게 하나의 좁은 업무와 이름을 부여할 것. 두 번째 에이전트를 구축하기 전에 검증 루프를 구축할 것. 에이전트가 버그를 수정하기 전에 재현하게 하고 모든 것에 증명을 첨부할 것. 에이전트가 틀렸을 때는 특정 이야기가 아닌 일반적인 원칙을 기록할 것. "빈도가 돈이 흐르는 곳"이므로 루틴을 매주 감사할 것. 위험한 작업에는 사람의 게이트를 유지할 것.

라이선스 및 사용. MIT — 이 저장소의 모든 내용을 자신의 프로젝트에 복사할 수 있습니다.

주목할 만한 공백(README가 주장하지 않는 것). 이 저장소는 xAI Grok Bot 플랫폼 자체의 사용 방법을 설명하지 않으며, 제품의 소스 코드를 포함하지 않고, 72시간 빌드를 넘어서는 성능 벤치마크를 주장하지 않으며, 라이선스 외의 현재 유지 관리 상태나 기여자 가이드라인을 문서화하지 않습니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트