# reasoning-validator

The reasoning-validator subagent for Claude Code checks reasoning chains with WFGY formulas and quantitative metrics, helping identify logical errors in assistant reasoning.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/wfgy/reasoning-validator.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/reasoning-validator

## What it does

This subagent adopts the Euclid persona on top of the Sonnet model, treating reasoning chains as mathematical structures. It tracks numerical indicators like semantic tension ΔS and reasoning resonance. If the resonance metric exceeds 0.3, the agent rejects the conclusion and triggers corrective formulas to reduce semantic residue.

Operation relies on internal commands prefixed with an asterisk. You can run `*validate-chain` to inspect reasoning steps, `*apply-bbpf` to explore parallel solution paths, or `*metric-report` to inspect calculated values. Upon launch, it runs initialization with `/wfgy:init` and attempts to pull formula parameters from `.wfgy/config.json`.

Execution depends on markdown command definitions located in `.claude/commands/wfgy/` and `.claude/commands/reasoning/`. Without those files present in the project tree, external validation commands will fail to run.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/reasoning-validator.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/reasoning-validator.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/reasoning-validator.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/wfgy/reasoning-validator.md

## When to use it
- test complex deduction chains against quantitative thresholds
- detect fallacies and logic gaps using WFGY mathematical formulas
- measure semantic tension and stability scores during problem solving
- trace alternative deduction paths in parallel

## Example prompts
- Check my reasoning steps using *validate-chain
- Calculate semantic tension across the argument with *calc-tension
- Explore alternative reasoning paths using *multi-path

## Similar
- [thought-based-reasoning](https://affpapa.org/en/nevibecode/skills/thought-based-reasoning.md) — skill · 1500 installs
- [dspy-reasoning-modules](https://affpapa.org/en/nevibecode/skills/dspy-reasoning-modules.md) — skill · ★ 125 repo stars
- [bayesian-reasoning-calibration](https://affpapa.org/en/nevibecode/skills/bayesian-reasoning-calibration.md) — skill · 162 installs
- [critical-thinking-logical-reasoning](https://affpapa.org/en/nevibecode/skills/critical-thinking-logical-reasoning.md) — skill · 2500 installs
- [recall-reasoning](https://affpapa.org/en/nevibecode/skills/recall-reasoning.md) — skill · 605 installs
- [clinical-diagnostic-reasoning](https://affpapa.org/en/nevibecode/skills/clinical-diagnostic-reasoning.md) — skill · 178 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
