ultragoal

Creates and executes durable multi-goal plans over Codex goal mode artifacts.

Updated Feb 1, 2024
One-click install
npx skills add https://github.com/ogiboy/portfolio-app --skill ultragoal-ogiboy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ultragoal
Source: https://github.com/ogiboy/portfolio-app/tree/main/.codex/skills/ultragoal
Command: npx skills add https://github.com/ogiboy/portfolio-app --skill ultragoal-ogiboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running multi-step work in Codex sessions loses track of goals, checkpoints, and completion evidence. Ultragoal turns a brief into durable repo-native artifacts and drives sequential goal execution with an auditable ledger. ## Core Features & Use Cases - Durable goal planning: Converts a brief into .omx/ultragoal/brief.md, goals.json, and ledger.jsonl with a stable aggregate Codex goal pointer. - Checkpointed execution: Loops through stories with get_goal/create_goal/update_goal reconciliation and structured ledger checkpoints for success, failure, and blocked states. - Evidence-backed steering: Supports explicit mutations like add_subgoal, split_subgoal, and reorder_pending with audit entries, without weakening verification. - Final quality gate: Requires ai-slop-cleaner, verification reruns, architecture-invariant audits, and independent code review before marking goals complete. - Use Case: A developer gives a feature brief, ultragoal decomposes it into stories, executes each under one aggregate Codex goal, and only completes after clean review evidence. ## Quick Start Ask the agent to run ultragoal with your brief, for example: create ultragoal goals from this feature brief and execute them to completion.

Frequently Asked Questions about ultragoal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create durable multi-goal plans in Codex?

Run omx ultragoal create-goals with a brief string, file, or stdin input. It writes goals.json, brief.md, and ledger.jsonl under .omx/ultragoal and registers a stable aggregate Codex goal pointing at those artifacts.

How do I execute ultragoal goals to completion?

Run omx ultragoal complete-goals in a loop, reconciling with get_goal and create_goal handoffs, then checkpoint each story with fresh Codex goal snapshots. The final story additionally requires a clean quality gate before update_goal marks completion.

Can I change the goal plan mid-execution?

Yes, use omx ultragoal steer with explicit mutation kinds like add_subgoal, split_subgoal, or reorder_pending, each backed by evidence. Steering never edits the aggregate objective, quality gates, or completion status, and all attempts are audited in the ledger.

Why does create_goal fail after a completed ultragoal run?

A completed Codex goal still occupies the thread until you manually run /goal clear in the Codex UI. Ultragoal intentionally never invokes goal clearing itself, so clear the previous goal before starting a new run in the same session.

What is required before the final goal can be marked complete?

The final gate requires targeted verification, an ai-slop-cleaner pass, an architecture-invariant audit, and independent code review with APPROVE and CLEAR statuses. Non-clean results record review blockers instead of completing the goal.