Ultragoal Workflow

When to use

Use for ultragoal, create-goals, complete-goals, durable multi-goal planning, or sequential execution over Codex /goal. Read AGENTS.md#durable-runtime-invariants-canonical-ssot for state ownership and goal-tool boundaries.

Inputs and preconditions

• Durable artifacts are .omx/ultragoal/brief.md, .omx/ultragoal/goals.json, and .omx/ultragoal/ledger.jsonl.
• New plans use aggregate Codex goal mode by default: one stable pointer objective for the plan while OMX tracks individual stories. Use --codex-goal-mode per-story only when explicitly requested.
• Do not call /goal clear from shell or this skill. After a completed run, the operator may clear the interactive Codex goal in the Codex UI before another same-thread run.

Operational steps: create

Run one command, then inspect the generated plan:

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>"

If refinement is needed, use explicit supported steering rather than editing durable artifacts by …