verify-finalize

verify-finalize

The verify agent's ONLY end-action. Build a manifest, call this script. Done.

Why this skill exists

verify-completion-audit gives deterministic detection of "the agent took screenshots and uploaded none." Detection alone is not enough: prompt-only enforcement can still be skipped during a long verify run.

This skill replaces the discipline rule with a mechanical can't-skip-it: the agent's only end-action is calling verify-finalize.sh. The script handles upload + post atomically. The agent CAN'T forget — there's no separate sub-step to forget.

When to use

Always, as the LAST tool call of every verify run. Replaces:

• All direct mcp__linear__create_attachment calls
• The single mcp__linear__save_comment call with the summary table

If preflight (Phase 0) blocked verify before iOS work, you still call verify-finalize with the BLOCKED-marked items. There's never a verify run that should NOT end with verify-finalize.

Manifest schema

JSON file. Required fields: issue_id, session_name, result, items. Optional: minor_fixes_applied.

{
  "issue_id": "ISSUE-123",
  "session_name": "ISSUE-123-verify-run14",
  "result": "complete",
  "minor_fixes_applied": "none",
  "items": [
    {
      "n": 1,
      "item": "swift build passes",
      "method": "cli",
      "status": "PASS",
      "evidence": "exit code 0"
    },
    {
      "n": 6,
      "item": "Header in Text mode",
      "method": "ios-simulator + video",
      "status": "PASS",
      "evidence_path": "<workspace>/verify-1.mp4",
      "evidence_kind": "video"
    },
    {
      "n": 12,
      "item": "Dynamic Type largest size",
      "method": "screenshot",
      "status": "PASS",
      "evidence_path": "<workspace>/verify-2.png",
      "evidence_kind": "image"
    },
    {
      "n": 8,
      "item": "iOS chrome",
      "method": "ios-simulator + video",
      "status": "BLOCKED",
      "evidence": "preflight: idb broken (pyexpat ImportError)"
    },
    {
      "n": 16,
      "item": "Aesthetic match vs design ref",
      "method": "human",
      "status": "SKIPPED: human-only"
    }
  ]
}