Skip to content

howlabs/verdict

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

verdict

Judgment layer for Claude Code. CI merges when visible tests pass — verdict checks whether that means anything.

Install

claude plugin install .

Or add this repo to a Claude Code marketplace (/.claude-plugin/marketplace.json).

Use

Command Effect
/verdict on Pre + Post + Stop gate
/verdict lite PostToolUse flags only
/verdict off Disabled

State: ~/.claude/.verdict-active. Artifacts: .verdict/ in the project.

Optional gate policy: verdict.gate.json (suite_adequacy: required or advisory).

Verify plugin

npm test

Reports

node hooks/report.js . --ci
node hooks/report.js . --pr
node hooks/plugin-compare.js .

Requirements

  • Python 3.9+ for .py mutation (ast.unparse in hooks/mutation-ast.py)
  • Node.js for hooks and JS/TS token mutation

Held-out and mutation tiers

Tier Held-out Mutation
Default Rule-based: spec bullets → keyword-presence pytest in .verdict/held-out/ Python: stdlib AST; JS/TS: token-scan (skips strings, comments, regex literals)
Recommended Set VERDICT_LLM=1claude -p generates behavioral held-out tests from spec

Rule-based held-out checks that keywords from the spec appear in source — not full behavior. A weak visible suite can still pass held-out while mutants survive. Use LLM held-out when you need behavioral coverage without hand-writing tests.

About

Claude Code judgment layer — held-out, mutation, hacking flags, gate

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors