autoresearch-goal

name	autoresearch-goal
description	Professor-critic research workflow with durable Omagy artifacts for agy.
argument-hint	<research topic with rubric or validation standard>

Omagy Autoresearch Goal

Use /omagy:autoresearch-goal when the user wants a research mission governed by an explicit professor-critic rubric and a durable completion gate, instead of an ad hoc answer or one-pass investigation.

Contract

• Omagy owns durable workflow state under .omagy/goals/autoresearch/<slug>/.
• omagy autoresearch-goal start emits a model-facing agy handoff; it does not secretly mutate native agy goal state.
• agy native goal APIs are not assumed. Until agy exposes a stable native goal API, agy_goal_adapter:"artifact" and native_goal_parity:false are the truth.
• Do not complete the research goal until professor-critic validation records verdict:"pass" and a final audit proves the topic/rubric are satisfied.
• If a host goal snapshot is available, pass it with --host-goal-json; if it is unavailable, the Omagy artifact state remains the source of truth.

Commands

omagy autoresearch-goal create \
  --topic "Map migration risk" \
  --rubric "PASS only when source citations support every recommendation." \
  --critic-command "node scripts/critic.js" \
  --slug migration-risk

omagy autoresearch-goal start --slug migration-risk

omagy autoresearch-goal verdict --slug migration-risk --verdict pass --evidence "critic approved report.md"
omagy autoresearch-goal verdict --slug migration-risk --verdict fail --evidence "critic rejected unsupported claim"
omagy autoresearch-goal verdict --slug migration-risk --verdict blocked --evidence "missing source access"

omagy autoresearch-goal complete --slug migration-risk --evidence "final audit passed"
omagy autoresearch-goal complete --slug migration-risk --evidence "final audit passed" --host-goal-json '<json-or-path>'

Workflow

1. Create the research mission and rubric if no workflow exists.
2. Start the goal and follow the handoff. Treat mission.json, rubric.md, and ledger.jsonl as the control plane.
3. Research iteratively against the rubric. Separate evidence from inference.
4. Record every meaningful critic pass, fail, or blocker with verdict.
5. Continue until the critic passes and the final answer satisfies the rubric.
6. Complete only after a passing verdict; include the strongest final evidence available.

Completion Gate

An autoresearch goal is incomplete unless .omagy/goals/autoresearch/<slug>/completion.json contains verdict:"pass" and passed:true. Assistant prose, partial source gathering, or a failed/blocked verdict is not sufficient.

Task: {{ARGUMENTS}}