Skill

seek-verdict

Verifies code review findings independently via Codex: dismiss false positives, confirm issues exist, or clarify impact. Handles P0-P2/Nit severities with policy-based outputs.

Git

code-quality

npx claudepluginhub sd0xdev/sd0x-dev-flow --plugin sd0x-dev-flow

Tool Access

This skill uses the workspace's default tool permissions.

Preview

- General code review (use `/codex-review-fast`)

Supporting Assets

references/policy-mapping.mdreferences/verdict-prompt.md

SKILL.md

Similar Skills

verify-findings

Verifies code-review and security-review findings for false positives using deep codebase tracing, framework-aware analysis, and web research. Produces a .verified.md report.

3 files

review

codex-peer-review

Performs symmetric two-AI peer reviews using OpenAI Codex CLI: independent blind reviews followed by structured per-issue debate for plans, code reviews, architecture, and recommendations.

3 files

codex-peer-review

receiving-code-review

Verifies code review findings against codebase and HOTL contracts, classifies as accept/reject/defer, records decisions, and implements only accepted changes before proceeding.

hotl

Stats

Stars147

Forks20

Last CommitMar 24, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

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