Skip to main content
subagent CX Codex

reasoning-validator — Claude Code subagent: what it does

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

no license ★ 1,357 updated 2026-03-01

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/reasoning-validator.md
Open on GitHub

What reasoning-validator 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.

What it helps with

  • 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 for the agent

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

How to install reasoning-validator

Manually: put the files in place

.claude/agents/reasoning-validator.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about reasoning-validator

How to install reasoning-validator in Claude Code?

Save the subagent configuration file directly into .claude/agents/reasoning-validator.md within your project root.

What does reasoning-validator do?

It assesses reasoning steps using WFGY equations, calculating numerical scores for semantic residue and resonance. When reasoning fails thresholds, it applies formulaic adjustments.

Which project files are required for operation?

The subagent looks for command files in .claude/commands/wfgy/ and .claude/commands/reasoning/. It also reads configuration parameters from .wfgy/config.json when present.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →
thought-based-reasoning NeoLabHQ thought-based-reasoning — a skill for Claude and other AI coders that gives the model a method for working through hard problems in explicit steps. Useful when a plain prompt returns the wrong answer. CX Codex +1 1,500installs dspy-reasoning-modules OmidZamani dspy-reasoning-modules guides configuration of DSPy 3.2.1 reasoning modules including RLM, ProgramOfThought, CodeAct, and Parallel. Useful for sandboxed code and long documents. CX Codex +1 ★ 125repo stars bayesian-reasoning-calibration lyndonkl The bayesian-reasoning-calibration skill applies Bayes' theorem to systematically revise probability estimates as new evidence arrives. It helps you forecast more accurately, avoid overconfidence, and justify why your beliefs change. CX Codex +1 162installs critical-thinking-logical-reasoning sammcj critical-thinking-logical-reasoning is a Claude Code skill that examines arguments in articles, reports and transcripts. It runs after an explicit request for critique. CX Codex +1 2,500installs recall-reasoning parcadei recall-reasoning — a Claude Code skill that digs through past sessions for decisions, working approaches, and dead ends. Query it before starting work similar to something already done. CX Codex +1 605installs clinical-diagnostic-reasoning curiositech clinical-diagnostic-reasoning detects cognitive biases in medical decisions, audits differential hypotheses, and structures diagnostic error reviews. Useful during treatment planning and clinical case debriefs. CX Codex +1 178installs

From the same set112

The whole set →
retrospective-analyzer retrospective-analyzer pulls sprint numbers from Linear and Git, finds problems that repeat across retros, and drafts action items with owners and dates. CX Codex +1 ★ 1,357repo stars boundary-guardian boundary-guardian monitors reasoning boundaries and detects semantic drift to stop AI hallucinations before invalid statements occur. CX Codex ★ 1,357repo stars react-pro react-pro — a React-focused subagent for building components, refactoring code, and tackling UI problems. It examines existing project patterns and includes testing in its workflow. CX Codex ★ 1,357repo stars Linear Todo Sync Linear Todo Sync pulls your open Linear tasks through the API and writes them as a markdown todo file in the project root. Useful when you want a quick view of assigned work. CX Codex +1 ★ 1,357repo stars strategic-analyst strategic-analyst simulates business and architecture scenarios, maps project constraints, and logs planned initiatives directly into Linear. CX Codex ★ 1,357repo stars svelte-testing The svelte-testing subagent helps test Svelte and SvelteKit apps, from component behavior to end-to-end flows. Use it when you need coverage for UI interactions or server-side functions. CX Codex ★ 1,357repo stars logic-synthesizer logic-synthesizer splits a hard problem into several parallel solution paths, weighs each one and merges the strongest parts into a single answer. CX Codex ★ 1,357repo stars cognitive-debugger cognitive-debugger — a diagnostic subagent for Claude Code that investigates reasoning breakdowns, traces error propagation across logic chains, and applies WFGY recovery protocols. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open