長期実行エージェントのワークフロー

タスクが複数のセッション、ハンドオフ、または生成されたエージェントにまたがる可能性がある場合は、このプレイブックを使用します。

目標

• 各新しいセッションにコンテキストを迅速に取り戻す方法を提供します
• 大きな変更を一度に行うのではなく、段階的に作業を続けます
• 追加する前に壊れたローカル ベースラインを把握しますコード
• 次のセッションが信頼できる耐久性のあるアーティファクトを残す

状態を保持する場所

• 人間、レビュー ボット、または複数のツールチェーンが同じタスク状態を必要とする場合は、docs/agent-runs/<slug>/ を使用します。
• タスク状態が意図的に 1 つのワークステーションに対してローカルである場合にのみ、.codex/runs/<slug>/ などのツールローカル ディレクトリを使用します。ツールチェーン。
• 後で別の投稿者またはエージェントが必要にする場合は、プライベート スクラッチ ファイルでマルチセッションの共有状態を非表示にしないでください。

必要なファイル

長時間実行タスクの開始時に次のファイルを作成します。

• feature-list.json
• progress.md

docs/agent-playbooks/templates/feature-list.template.json のテンプレートを使用し、 docs/agent-playbooks/templates/progress.template.md.

エージェントがドキュメント全体を書き換えることなく少数のフィールドを更新できるように、機能リストには JSON を優先します。

セッション開始チェックリスト

1. pwd を実行します。
2. progress.md を読み取ります。
3. feature-list.json を読み取ります。
4. git log --oneline -20 を実行します。
5. ./scripts/agent-init.sh --smoke を実行します。
6. 最も優先度の高いものを 1 つだけ選択してくださいpending、in_progress、または blocked のままのアイテム。

スモーク ステップが失敗した場合は、新しい機能スライスを実装する前に壊れたベースラインを修正します。

セッション ルール

• 一度に 1 つの機能またはタスク スライスを処理します。
• 機能リストを機械が読み取り可能な状態に保ちます。安定しています。無関係なアイテムを書き換えるのではなく、ステータス、メモ、ファイル、検証フィールドを更新します。
• そのアイテムにリストされているコマンドまたはユーザー フローを実行した後でのみ、アイテムに検証済みのマークを付けます。
• 全体的なタスク状態の所有権ではなく、境界付きスライスに生成されたエージェントを使用します。
• 子エージェントが 1 つのアイテムを所有する場合は、正確なアイテム ID、受け入れ基準、および接触する可能性のあるファイルを子エージェントに与えます。

セッション終了チェックリスト

1. 短い進捗エントリを progress.md に追加します。
2. feature-list.json でタッチした項目を更新します。
3. 検証のために実行した正確なコマンドを記録します。
4. 阻害要因、フォローアップ、再開する次善の項目をキャプチャします。

推奨される進捗エントリの形状

次のような短い構造:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.