# Grok Bot Field Notes

> A repository of agent rules, role playbooks, a bot role roster and a failure log drawn from the xAI Grok Bot team's 72-hour live build.

Grok Bot Field Notes is an MIT-licensed GitHub repository published by unicodef1wn. It collects rules, playbooks, bot role definitions and a failure log drawn from a 72-hour live build of a product from an empty repo by three engineers from the xAI Grok Bot team, per the README. The latest listed release is v1.0.

## What It Is

The repository is a set of documents and reusable agent configuration rather than a running application. Its core file, AGENTS.md, holds house rules for a coding agent: placed in a repo root, the agent reads it. Longer references cover verification, orchestration, skills and routines, and prompts.

The repo also includes ANTIPATTERNS.md, a list of forty things that broke on air, each with what broke, why, and the resulting rule.

## What's Inside

- A roster of sixty-nine agent roles, one file each, covering what the role owns, what it doesn't, where it gets facts, what needs approval, and a pasteable description.
- Nine role playbooks: engineering, PM, founders, sales engineering, sales, SDR, support, post-sales and marketing.
- Two PDF guides: a 24-page story of the three days and a 14-page marketing guide.
- Cursor ports of the roster as one .mdc rule per role, for copying into .cursor/rules/.
- A pull request template that turns the verification loop into a form covering reproduction, proof, scope and human review.
- Reference files on economics and on product behavior such as memory, permissions and isolation, plus daily structured notes.

## Core Guidance

The README summarizes the approach: give each agent one narrow job and a name, build a verification loop before a second agent, and make agents reproduce a bug before fixing it and attach proof. It also advises auditing routines weekly and keeping a human gate on migrations, deploys, money and permissions.

## Setup Path

Copy AGENTS.md into a repository with a curl command, or copy the Cursor rule files and PR template into your own project.

## Features
- AGENTS.md house rules for coding agents
- Forty-item antipattern and failure log
- Sixty-nine agent role definitions
- Nine role playbooks
- Cursor .mdc rule ports
- Pull request template with verification proof
- Two PDF guides
- Economics and product reference notes

## Integrations
Cursor, GitHub

## Platforms
API

## Pricing
Open Source

## Version
v1.0

## Links
- Website: https://github.com/unicodef1wn/grokbot-field-notes
- Repository: https://github.com/unicodef1wn/grokbot-field-notes
- EveryDev.ai: https://www.everydev.ai/tools/grokbot-field-notes
