Ultragoal

Create a plan from a brief:

omq ultragoal create-goals --brief-file plan.md

Or with explicit stories:

omq ultragoal create-goals --brief "ship the migration" \
  --goal "Schema::Add new columns" \
  --goal "Backfill::Backfill rows in batches" \
  --goal "Cutover::Drop old columns and switch reads"

The default mode is aggregate (one Claude /goal covers the run). Pass --claude-goal-mode per-story if you want each story to have its own /goal.

Multi-repo workspaces / parallel sessions: when several Claude sessions in the same workspace need to run /ultragoal concurrently, pass either --plan-id <stable-id> or --auto-plan-id so the plan is written to .omq/ultragoal/plans/{planId}/ instead of the shared single-plan path. Without that flag, two sessions creating goals would clobber each other. --auto-plan-id derives {epochMs}-{slug} from the brief title. Then thread the same --plan-id <id> through every subsequent subcommand in that session. Use omq ultragoal list-plans to enumerate available planIds when needed.

Start (or resume) the next story:

omq ultragoal complete-goals

This prints a model-facing handoff. The active Claude agent must read it and:

• Confirm/Set the active /goal condition in this session.
• Work the story.
• When the story is complete (and for the final story, after the full quality gate), share back a snapshot of the active /goal state and call checkpoint.

Checkpoint a story:

omq ultragoal checkpoint --goal-id G001-... --status complete \
  --evidence "tests/files/PR evidence" \
  --claude-goal-json '{"goal":{"objective":"...","status":"active"}}'

For the final story, also pass --quality-gate-json containing aiSlopCleaner, verification, and codeReview evidence (all clean).

If the final review is not clean, do NOT mark complete. Record blockers:

omq ultragoal record-review-blockers --goal-id G00X-... \
  --title "Resolve final code-review blockers" \
  --objective "Fix the listed review findings and rerun final gates" \
  --evidence "<the review findings>" \
  --claude-goal-json '{"goal":{"objective":"...","status":"active"}}'

This appends a new blocker story and keeps the Claude /goal active.

Inspect state at any time:

omq ultragoal status