# Omagy Performance Goal Contract

Status: implementation contract for the agy-adapted performance-goal runtime.

Omagy aligns with OMX at the workflow boundary: durable state, evaluator
contract, pass/fail/block checkpoints, and completion gated by passing
validation evidence.

Until Antigravity CLI exposes a stable native goal API, Omagy uses artifacts as
the source of truth:

- `.omagy/goals/performance/<slug>/state.json`
- `.omagy/goals/performance/<slug>/evaluator.md`
- `.omagy/goals/performance/<slug>/ledger.jsonl`

`state.json` must identify `agy_goal_adapter:"artifact"` and
`native_goal_parity:false`. Host goal snapshots are optional reconciliation
inputs through `--host-goal-json`; they are not required for completion while
agy lacks a stable native goal API.

The supported command surface is:

- `omagy performance-goal create`
- `omagy performance-goal start`
- `omagy performance-goal checkpoint`
- `omagy performance-goal complete`
- `omagy performance-goal status`

Completion requires a prior checkpoint with `--status pass`. If a host goal
snapshot is supplied during completion, it must match the performance objective
and be complete.