ultragoal

Ultragoal ワークフロー

使用するタイミング

ultragoal、create-goals、complete-goals、永続的な複数ゴールの計画、または Codex /goal に対する逐次実行を行う場合に使用します。状態の所有権とゴールツールの境界については、AGENTS.md#durable-runtime-invariants-canonical-ssot を参照してください。

入力と前提条件

• 永続アーティファクトは .omx/ultragoal/brief.md、.omx/ultragoal/goals.json、.omx/ultragoal/ledger.jsonl です。
• 新しい計画では、デフォルトで集約 Codex ゴールモードを使用します。これは、計画全体に対する安定したポインタ目標を 1 つ設定し、OMX が個々のストーリーを追跡する方式です。--codex-goal-mode per-story は、明示的に要求された場合にのみ使用してください。
• シェルやこのスキルから /goal clear を呼び出さないでください。完了した実行の後、同じスレッドで別の実行を行う前に、オペレーターが Codex UI で対話型の Codex ゴールをクリアすることがあります。

運用手順: 作成

コマンドを 1 つ実行し、生成された計画を確認します:

omx ultragoal create-goals --brief "<brief>"
omx ultragoal create-goals --brief-file <path>
cat <brief> | omx ultragoal create-goals --from-stdin
omx ultragoal create-goals --codex-goal-mode per-story --brief "<brief>"

調整が必要な場合は、永続アーティファクトを手作業で編集するのではなく、明示的にサポートされているステアリングを使用してください。

運用手順: 実行

omx ultragoal status がすべてのゴールの完了を報告するまで繰り返します:

1. omx ultragoal complete-goals を実行し、そのハンドオフを読みます。
2. get_goal を呼び出します。アクティブな Codex ゴールが存在しない場合にのみ、表示されたペイロードで create_goal を呼び出します。それ以外の場合は、対応する集約目標を継続します。
3. OMX のストーリーを 1 つ完了させ、その目標を実際のアーティファクトと検証の証拠に照らして監査します。
4. 中間の集約ストーリーでは、Codex ゴールをアクティブなまま維持し、チェックポイントを記録します:

   omx ultragoal checkpoint --goal-id <id> --status complete --evidence "<evidence>" --codex-goal-json <fresh-get-goal-json-or-path>
   

5. ブロックされた、または失敗したストーリーでは、証拠を添えて --status blocked|failed を使用します。失敗した作業を再開するには omx ultragoal complete-goals --retry-failed を使用します。
6. 最終ストーリーでは、update_goal({status: "complete"}) の前に、以下の最終ゲートを完了させます。その後、get_goal を再度呼び出し、新しい完了スナップショットをチェックポイントとして記録します。

明示的なステアリング

分解の内容を変更する必要がある場合にのみ、証拠に基づいたディレクティブを使用します:

omx ultragoal steer --kind add_subgoal --title "<title>" --objective "<objective>" --evidence "<evidence>" --rationale "<reason>" --json
omx ultragoal steer --directive-json ./steering.json --json

サポートされる種類は add_subgoal、split_subgoal、reorder_pending、revise_pending_wording、annotate_ledger、mark_blocked_superseded です。通常の文章では計画は変更されず、同じ構造化ディレクティブが繰り返された場合は重複排除されます。

フェーズ/HUD への引き渡し

スタンドアロンで有効化する際に、最も小さく正確なフェーズ（planning、executing、verifying、reviewing、checkpointing、blocked）を宣言します:

omx state write --input '{"mode":"ultragoal","active":true,"current_phase":"planning"}' --json

Autopilot 内では、親モードをアクティブなまま維持し、current_phase:"ultragoal" を設定します。コードレビューに引き渡す前に、Ultragoal の証拠を handoff_artifacts.ultragoal の下に保存してください。スタンドアロンの Ultragoal は、永続的なすべてのゴールが完了した場合にのみ完了とマークします。

オプションの Team ブリッジ

ストーリーを並列に実行する場合は、別の Team コマンドを使用します。リーダーは、新しい get_goal スナップショットを使って Ultragoal のチェックポイントを記録します。ブリッジの詳細については、Team スキルを参照してください。

最終ゲートと終了時の証拠

最終的に完了させる前に:

1. 対象を絞ったストーリーの検証を実行します。
2. 変更されたファイルに対して ai-slop-cleaner を実行し、その後検証を再実行します。
3. ブリーフ/仕様/承認されたステアリングに含まれるすべてのアーキテクチャ/ドメインの不変条件を、実装、テスト、レビューの証拠と照らして監査します。
4. 独立した code-reviewer と architect のレーンを通じて $code-review を実行します。レビューまたは不変条件の証明がクリーンでない場合は、Codex ゴールを更新せず、永続的なブロッカーを記録します:

   omx ultragoal record-review-blockers --goal-id <id> --title "Resolve final code-review blockers" --objective "<objective>" --evidence "<findings>" --codex-goal-json <active-get-goal-json-or-path>
   

5. クリーンである場合は、update_goal({status: "complete"}) を呼び出し、get_goal を呼び出したうえで、クリーナー、検証、レビュー、アーキテクチャの不変条件に関する証拠を含む --quality-gate-json を付けてチェックポイントを記録します。

ゴール ID とステータス、台帳/チェックポイントのパス、新しいゴールスナップショットの証拠、レビューの判定、およびブロッカーがあればそれを報告してください。OMX の状態だけを根拠に完了を主張しないでください。