seek-verdict

seek-verdict: Independent Second-Opinion Verification

When NOT to Use

• General code review (use /codex-review-fast)
• Architecture debates (use /codex-brainstorm)
• Nit findings with no dismiss intent (use [NIT_DEFERRED])

Intent x Severity

Intent	Purpose	Eligible Severities	Output Token
dismiss	Is this a false positive?	All (P0/P1/P2/Nit)	[DISMISS_VERDICT]
confirm	Does this issue actually exist?	All	[SEEK_VERDICT]
clarify	What's the actual impact?	All	[SEEK_VERDICT]

Default intent: dismiss (backward compatible with v1).

Dismiss Authorization

Severity	Authorization	Gate
P0	DISMISS_CANDIDATE	Human confirmation required
P1	DISMISS_CANDIDATE	Human confirmation required
P2	DISMISS_VERIFIED	Automated
Nit	DISMISS_VERIFIED	Automated

P0/P1 dismiss produces a candidate, not a final authorization. See Policy Mapping for human gate protocol.

3-Phase Protocol

sequenceDiagram
    participant C as Claude
    participant S as seek-verdict
    participant X as Codex (fresh thread)

    C->>S: Finding + intent + severity
    Note over S: Phase A: Candidate Packaging
    S->>S: Extract finding_packet<br/>(no Claude conclusions)
    S->>X: Phase B: Blind Independent Verdict
    Note over X: Independent research<br/>git status / grep / cat
    X-->>S: verdict + confidence + evidence
    Note over S: Phase C: Policy Mapping (intent x severity)
    alt intent=dismiss + P2/Nit
        S-->>C: DISMISS_VERIFIED / FIX_REQUIRED (automated)
    else intent=dismiss + P0/P1
        S-->>C: DISMISS_CANDIDATE + Need Human (human gate)
    else intent=confirm/clarify
        S-->>C: [SEEK_VERDICT] informational result
    end

Phase A: Candidate Packaging

Extract finding artifact from review output:

Field	Source
finding_key	file + canonical_issue_text
severity	<P0 | P1 | P2 | Nit>
intent	<dismiss | confirm | clarify>
original_finding_text	Codex review original (secrets redacted)
origin_thread_id	Review session threadId
current_head_sha	git rev-parse HEAD
relevant_diff	git diff HEAD -- <file>

Critical: Record Claude's hypothesis locally. Never send it to Codex.

Phase B: Blind Independent Verdict

Use the prompt template in Verdict Prompt.

Requirement	Detail
Thread	Fresh mcp__codex__codex (never reuse review thread)
Sandbox	read-only
Approval policy	never
Anti-anchoring	No Claude conclusions in prompt

Phase C: Policy Mapping

Apply thresholds from Policy Mapping.

Dismiss intent: graduated thresholds by severity (P0: 0.95/4, P1: 0.90/3, P2: 0.80/2, Nit: 0.70/1).

Confirm intent: ACTIONABLE->CONFIRMED, NON_ACTIONABLE->DISPUTED, low confidence->UNCERTAIN.

Clarify intent: HIGH_IMPACT / LOW_IMPACT / UNCERTAIN.

Output audit trail per Policy Mapping.

Rebuttal

If Codex returns FIX_REQUIRED and Claude has objective counter-evidence:

• 1 round max via mcp__codex__codex-reply (same verdict thread)
• Only objective artifacts (tests, specs, language semantics)
• After rebuttal: still FIX_REQUIRED -> fix; ambiguous -> NEED_HUMAN

Anti-Abuse Guard

See Policy Mapping for full rules.

• Dismiss: 3 consecutive DISMISS_VERIFIED -> [DISMISS_PATTERN_WARN] + heightened thresholds
• Confirm/Clarify: per-finding cap (1 confirm + 1 clarify per finding per commit)
• Session end or branch switch resets all counters

Output

Dismiss intent:

[DISMISS_VERDICT] key=<file|canonical_issue> | severity=<P0-Nit> | verdict=<DISMISS_VERIFIED|DISMISS_CANDIDATE|FIX_REQUIRED|NEED_HUMAN> | confidence=<0..1> | codex_thread=<id> | evidence=<brief> | timestamp=<ISO8601> | intent=dismiss | authorization=<automated|human-required|human-confirmed>

Confirm/Clarify intent:

[SEEK_VERDICT] key=<file|canonical_issue> | severity=<P0-Nit> | intent=<confirm|clarify> | verdict=<CONFIRMED|DISPUTED|HIGH_IMPACT|LOW_IMPACT|UNCERTAIN> | confidence=<0..1> | codex_thread=<id> | evidence=<brief> | timestamp=<ISO8601>

Verification

• Intent is valid (dismiss / confirm / clarify)
• Codex prompt contains no Claude conclusions (anti-anchoring)
• Fresh Codex thread used (not review session thread)
• Correct audit trail token output ([DISMISS_VERDICT] or [SEEK_VERDICT])
• P0/P1 dismiss produces DISMISS_CANDIDATE + human gate (never auto-dismiss)
• Anti-abuse streak tracked (dismiss) / per-finding cap enforced (confirm/clarify)

References

File	Purpose
Verdict Prompt	Codex blind verification prompt template
Policy Mapping	Intent x severity thresholds, audit format, anti-abuse