run-github-project

GitHub プロジェクトの実行

基本原則

Project はライブの制御プレーンです。最新のボード状態と、この実行に固有の権限付与によって、すべての判断、書き込み、完了処理を決定します。 デフォルトのレーンは Backlog → Todo → Ready to implement → In progress → Done です。信頼できるバインディングの検証済みオプション ID を通じて、各レーンを解決してください。

不変条件

1. 列の権限: 現在の列への所属がチケットの権限を与えます。遷移履歴は権限を与えません。Backlog は読み取り専用です。Backlog では、チケットのクレーム、計画、トリアージ、エピックのクローズ、クリーンアップの再開を行わないでください。アイテムを Backlog から移動できるのは人間だけです。自動作業は Todo から開始します。
2. ライブ権限: クレーム、選択、マージ、復旧、完了には、完全で最新の状態が必要です。キャッシュや部分的な読み取りは手掛かりにとどめ、変更済みまたは未検証のレコードのみを再取得してください。再利用したスナップショットからであっても、各クレーム、書き込み、マージの前に、その操作に固有の権限を再確認してください。ランカーによる適格性判定は、何の権限も与えません。
3. コントローラーの所有権: Project の共有状態のクレーム、割り当て、変更、マージ、イシューのクローズ、調整を行うのはコントローラーだけです。チケットエージェントが所有するのは、自身のワークツリー、ブランチ、マージ以外の PR 変更のみです。
4. 結果が不明な場合: 失敗した変更や公開の結果が不明な場合は、再試行したり、容量を解放したり、成功を報告したりする前に、状態を照合してください。
5. 維持: ブロック中の作業、依存関係によって保留中の作業、人間が行う作業は、所有者、クレーム、スロット、ドラフト、成果物、権限付与、予算を保持したまま、それぞれのフロンティアに残してください。キューを空にするために状態を変更しないでください。解放された容量は、空きスロットでのみ再開します。
6. 所有者を維持: フィードバック、修正、変更では、Todo／Ready に戻すことなく、所有者、クレーム、スロットを維持してください。影響を受けるチェックとレビューは最終ヘッドで更新し、それ以前のヘッドで得た証拠に依存しないでください。
7. ゲートを勝手に作らない: 提供された状態にない権限、容量上限、プロバイダー、前提条件を推測しないでください。他の作業が待機中でも、独立して実行可能な作業は続行してください。
8. 提供された状態: 完全な状態が提供されている場合は、追加の Project またはリポジトリ読み取りを行わずに、レビュー、セットアップ、分析を判断してください（参照情報は引き続き読み取ってください）。このワークスペースに存在しないプロバイダーではなく、説明された環境を評価してください。検証済みの提案差分は、まだ書き込まれておらずコミットされていなくても configuration-ready-to-commit です。プロファイルの選択ではルーティングサービスを呼び出さず、クレームやマージの権限も付与されません。古いルーティングフィールドは編集せず、無視してください。
9. 抜け道なし: 権限の更新や変更によって、保留中の CI を再開したり、ライブターンを付与したり、適格性をリセットしたりしてはなりません。不明または古い証拠がある場合、依存する作業はブロックされます。アーキテクチャに重大な変更がある場合は、完全な再計画とレビューが必要です。権限または適格性が変更された場合は、ステークホルダーまたは情報源による判断が必要です。

検証済みの引き継ぎは、deliver-spec の範囲内の実装、テスト、修正と、独立した統合候補レビューを 1 回含みます。再計画では検証済みの計画状態を維持し、実際に人間の対応が必要な作業は、判断のための一時停止状態に戻します。drain では、検証済みの権限保留と、適格性を満たす終端状態の必須 CI クレームを容量の対象外として保留してから更新します。next では、必須 CI の停滞中もスロットを維持します。誤った計画上の接続部分が、原因診断 1 回と修正 2 回の後も失敗している場合は、再計画パケットが必要です。CI 以外の失敗が繰り返される場合は、所有者が引き続き対応し、能力に応じて選ばれた読み取り専用の証拠収集ヘルパーに 1 回依頼します。新たな指示が得られた場合のみ作業を再開し、そうでなければ具体的なブロッカーを報告します。

モードを選択する

• review：確認または説明のみを行います。setup：バインディングの設定または検証のみを行います。
• next：デフォルトです。選択する課題は最大1件です。起動時のマージ判断が確定した後は、それ以上待機せずに waiting-for-human を返します。名前付きの Wayfinder 子項目は next のままです。
• drain：明示的に drain／全件実行／空になるまでの実行を依頼された場合のみ使用します。チケット数の上限はありません。リモート待ちまたは人待ちだけが残る場合は、Refresh Gate に置き換わることなく、読み取り専用の Project Watcher を実行します。

実行権限に従い、起動時にマージの許可を一度だけ確認します。明示的なマージまたはマージ禁止の指示があれば従います。それ以外の場合は、デフォルトを「許可しない」とする60秒の期限を設けて確認し、その間もデリバリーを続けます。許可がない場合は、準備が整った PR を提供し、マージのみ一時停止します。

作業前に読む

モード	必須のリファレンス
review または setup	レビューとセットアップ
next または drain	バインディングの検証にはレビューとセットアップ、続いて実行コントローラーとチケットのライフサイクル

実行時は、まずワークフロープロバイダーも読みます（暗黙にインストールしないでください）。受け入れ作業の前には権限と一時停止およびレビュー契約を読みます。drain では、drain キューの作業を始める前にdrain スケジューラーを最後まで読みます。分析の場合も、まず該当するセクションを読んでください。

質問の内容	読むもの
ディスパッチ前の準備状況、適格性、実行中のターン	無人実行の準備状況
容量、共有パス、更新、タイミング、CI の保留	Drain スケジューラー
プランナーの譲渡、修正、再計画	Todo レーン
設定の変更または更新	プロジェクト設定
エージェントプロファイルまたはヘルパーの割り当て	エージェントのルーティング

各項目に回答する

チケットまたはシナリオごとに、分類と安全な次のアクション、正確に保持された状態と再開の根拠（ブロックされた操作自体の結果は使わない）、実行前に再度行うチェックを示します。 サイクルを繰り返す場合は、前回のサイクルの根拠と比較し、範囲を限定した次のアクションを1つ、または正確なブロッカーを示します。

最終レポート

レーンの終端状態とレポートの契約に従います。結果を最初に示し、再開条件を含むブロッカーとユーザーの次のアクションを記載します。未解決の前提条件がある場合は、空の drain ではなく部分的な作業です。監査の詳細は最後に記載します。タイミング手順に従って所要時間を報告します。