autoresearch-goal

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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

```bash
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}}

From shayne-snap/oh-my-antigravity, MIT.

More from shayne-snap/oh-my-antigravity