unicodef1wn/grokbot-field-notes

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のエージェントロールがあり、ロールごとに1つのファイルで、その役割の責任範囲、非責任範囲、事実の取得元、承認が必要な事項、および貼り付け可能な説明が記述されています。playbooks/ には、ボットチーム、ワークフロー、プロンプト、数値を含む9つのロールワークショップ（エンジニアリング、PM、ファウンダー、セールスエンジニアリング、セールス、SDR、サポート、ポストセールス、マーケティング）があります。ports/ は名簿を Cursor 特有のルールファイルに変換します。
• ガイドとリファレンス。 guide/ には2つの PDF が含まれています：24ページの Grok Bot Guide by SpaceX Engineers（3日間のストーリー、メンタルモデル、故障ログ、経済性）と14ページの Grok Bot Marketing Guide（6つのボットにわたるキャンペーン実行、ローンチ日の成長、配信）。reference/ には2つの短いファイルがあります：ECONOMICS.md（すべてのコストとメトリクス、およびそれをサポートするルール）と PRODUCT.md（どの Grok Bot 機能がボット設計に影響するか）。notes/ には、すべての主張を裏付ける構造化された日々のメモがあります。
• ワークフローヘルパー。 .github/ には、検証ループをフォームに変えるプルリクエストテンプレートが含まれています：再現済み、証明添付、スコープ、人間の承認が必要。README は、「移行、デプロイ、金銭、権限」を、エージェントループがどれほど上手く機能していても人間によるゲートを維持すべきアクションとして明示的にリストしています。

核心となる哲学。 README の1段落の要約が運営原則を捉えています：各エージェントに1つの狭い仕事と名前を与えること。2つ目のエージェントを構築する前に検証ループを構築すること。エージェントにバグを修正させる前に再現させ、すべてに証明を添付すること。エージェントが間違ったときは、特定のストーリーではなく一般的な原則を書き留めること。「頻度こそが金銭の流れる場所」であるため、ルーチンを毎週監査すること。危険なアクションには人間のゲートを維持すること。

ライセンスと使用。 MIT — このレポジトリから何でも自分のプロジェクトにコピーできます。

注目すべきギャップ（README が主張していないこと）。 このレポジトリは xAI Grok Bot プラットフォーム自体の使用方法を説明しておらず、製品のソースコードを含んでおらず、72時間のビルドを超えるパフォーマンスベンチマークを主張しておらず、ライセンス以外の現在のメンテナンス状況や貢献者ガイドラインを文書化していません。