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.
At a Glance
Guides, rules, playbooks and roster content in the repository, released under the MIT License and free to copy into your own repo.
Engagement
Available On
Listed Nov 2026
About Grok Bot Field Notes
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.
Community Discussions
Be the first to start a conversation about Grok Bot Field Notes
Share your experience with Grok Bot Field Notes, ask questions, or help others learn from your insights.
Pricing
Open Source (MIT)
Guides, rules, playbooks and roster content in the repository, released under the MIT License and free to copy into your own repo.
- MIT License
- AGENTS.md house rules for coding agents
- ANTIPATTERNS.md failure log
- Sixty-nine agent role files in roster/
- Nine role playbooks
Capabilities
Key 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

