ループのどのターンも同じ流れで動きます。トリガーがWebhookでも時計でも、誰かが直接ゴブリンにメンションした場合でも同じです。このページは、そのトリガーからマージリクエストまでの間で起きていることです。
1. トリガーが届く
TaskGoblinはその仕事のスレッド（1つの課題、1つのマージリクエスト、1つのループの会話）を見つけるか作成し、そのターンを中のメッセージとして記録します。進行中の仕事への追いかけの依頼は、新しいスレッドではなく既存のスレッドに入ります。ゴブリンが説明のやり直しを求めないのはこのためです。
2. サンドボックスが立ち上がる
実行にはリポジトリのチェックアウトを含む隔離クラウドコンテナが割り当てられます。サンドボックスは永続的で、同じスレッドのターン間で再利用されるため、追いかけの依頼はリポジトリと前ターンの状態がすでにある環境に着地します。ゴブリンは空の箱からではなく、続きから始めます。
多くの場合は事前に温められているので、実行は冷たいコンテナを待つのではなく数秒で作業を始めます。隔離・永続性・セルフホストの詳細はクラウドサンドボックスにあります。
3. 書く前に読む
コードに触れる前に、ゴブリンは文脈を集めます。起動のきっかけになった課題や差分、スレッドの履歴、前のゴブリンが残した引き継ぎメモ、そして組織の規約です。イベントループなら、あなたの恒常的な指示がイベント自体の文脈の上に重なります。
役に立つ変更と、それらしいだけの変更を分けるのがこの段階です。前回の変更がどうレビューされたか、以前の方針がなぜ取り消されたかを見られるエージェントは、空の部屋から始めるエージェントより良い判断をします。
4. 本物のコーディングエージェントが作業する
サンドボックスの中では本物のコーディングエージェント（Claude Code、Codex、Gemini のいずれか。その実行のモデルアカウントによります）が動きます。開発者と同じ道具を持ち、ファイルを読み書きし、コマンドを実行し、あなたのテストを走らせます。差分を補完しているのではなく、問題そのものに取り組んでいます。
5. ブランチ、コミット、プッシュ、マージリクエスト
ゴブリンはチームがすでに使っている流れに従います。
- 専用ブランチで作業します。GitLabやGitHubの課題142なら
142-taskgoblin、Jiraキーならproj-123-taskgoblin。デフォルトブランチでは決して作業しません。 - 追跡しやすいよう署名してコミットし、ブランチをプッシュします。
- マージリクエスト（GitLab）またはプルリクエスト（GitHub）を開き、作業が始まった場所へリンクを報告します。
例外は既存のマージリクエスト上で起動された実行です。その場合は競合するブランチを作らず、そのMRのブランチにプッシュします。
出力がブランチとマージリクエストなので、レビューは人の貢献に対してすでに行っていることそのままです。あなたの承認なしにマージされるものはありません。
6. あなたがすでに見ている場所へ報告する
実行中、ゴブリンはその作業が属する場所を通じて報告します。Linear課題のアクティビティ、マージリクエストのインラインコメント、SlackやTeamsの自動更新されるカード。ターミナルを見張る必要はなく、開くのを覚えておくべき別のダッシュボードもありません。
7. 起きたことを書き残す
ゴブリンが最後にすること — 返信を送った後で、決して前ではなく — は引き継ぎメモの記録です。学んだこと、決めたこと、未解決のこと。次のターンはそれを最初に読みます。
ループが繰り返しではなく積み上がるのはこのためです。ブレインをご覧ください。
秘密はエージェントの外に置かれる
ゴブリンがあなたの資格情報を見ることはありません。サンドボックス内のGitアクセスは実行時に組織単位で用意され（GitLabのOAuthトークン、または新しく発行されたGitHubのインストールトークン）、エージェントに読ませるのではなくその周囲の環境に注入されます。クローンとプッシュに必要なアクセスを使うことはできますが、あなたの秘密がその文脈や記録に入ることはありません。
そのトークンはGitの通信専用です。コメント、レビュー、課題の更新はTaskGoblin自身の連携を通るので、あなたではなくゴブリンとして投稿されます。
うまくいかなかったとき
失敗した実行が消えることはありません。ゴブリンは起動元の場所ではっきり報告し、失敗はその実行に記録され、引き継ぎメモはぶつかった壁を持ち越すので、次のターンが同じ壁を再発見せずに済みます。サンドボックスに至らなかった実行（残高切れで止められた場合など）は課金されません。
次に読むもの
- クラウドサンドボックス — 隔離、永続性、自社インフラでの実行。
- ブレイン — 仕事を前に運ぶ、書き留められた知識。
- 料金とクレジット — 1ターンの費用、秒単位の計測。