OpenParable
Skip to content
← Back to skills

Autoresearch Goal

Research
autoresearch-goal

Autoresearch Goal is an Agent Skill for research published in the Yeachan-Heo/oh-my-codex repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Durable professor-critic research workflow over Codex goal mode without reviving deprecated omx autoresearch

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Yeachan-Heo/oh-my-codex/blob/HEAD/plugins/oh-my-codex/skills/autoresearch-goal/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/autoresearch-goal, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Autoresearch Goal

Use this workflow when a research mission should be bound to Codex goal-mode focus while OMX remains the durable state owner. This is for research projects that need Codex goal-mode management plus professor/critic-style validation; it is not the default answer for ordinary pre-planning best-practice lookup.

Boundary

  • Do not use or revive the deprecated omx autoresearch direct launch surface.
  • Do not claim shell commands mutate hidden Codex /goal state.
  • Do not edit upstream ../../codex or add dependencies.
  • Use get_goal, create_goal, and update_goal({status: "complete"}) only through the active Codex thread when those tools are available.

Artifacts

omx autoresearch-goal writes:

  • .omx/goals/autoresearch/<slug>/mission.json
  • .omx/goals/autoresearch/<slug>/rubric.md
  • .omx/goals/autoresearch/<slug>/ledger.jsonl
  • .omx/goals/autoresearch/<slug>/completion.json

Flow

  1. Create the mission and professor-critic rubric: omx autoresearch-goal create --topic "..." --rubric "..." --critic-command "..."
  2. Emit the model-facing handoff: omx autoresearch-goal handoff --slug <slug>
  3. In the active Codex thread, call get_goal; call create_goal only if no active goal exists and the printed payload is the intended objective.
  4. Research iteratively against the rubric. Record every critic outcome: omx autoresearch-goal verdict --slug <slug> --verdict <pass|fail|blocked> --evidence "..."
  5. Completion is blocked until professor-critic validation records verdict=pass. After the mission audit passes, call update_goal({status: "complete"}), call get_goal again, then run: omx autoresearch-goal complete --slug <slug> --codex-goal-json <get_goal-json-or-path>
  6. Treat the completion command as read-only reconciliation plus durable OMX state update; hooks and shell commands must not mutate Codex goal state.
  7. After the completion command succeeds, run /goal clear in the Codex UI before starting another goal in this same thread/session. OMX prints this terminal cleanup step but does not invoke hidden clear routes.

Completion gate

A passing professor-critic artifact and a matching complete Codex get_goal snapshot are required. Assistant prose, partial tests, or a failed/blocked verdict are not sufficient.

Lifecycle: create_goal starts the Codex thread goal, update_goal({status: "complete"}) marks terminal success after the professor-critic and audit pass, and /goal clear removes the completed thread goal when another same-thread goal is needed. OMX shell commands and hooks reconcile snapshots and print the cleanup instruction; they must not mutate hidden Codex goal state.