A skill for coding agents that makes them produce a test plan (SPEC) before coding and an evidence report after, instead of humans reading the code, by running the code through a gauntlet of automated checks.

Stars

122

7-day growth

No data

Forks

7

Open issues

0

License

MIT

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

Inspired by Uncle Bob's strategy, it flips traditional code review by trusting automated checks over manual code reading, and includes advanced checks like mutation testing, property-based tests, and supply chain scanning.

Who it is for

  • Developers using coding agents (Claude Code, Codex CLI, Cursor, Aider, etc.)
  • Teams wanting to trust AI-generated code without manual line-by-line review
  • Quality assurance engineers focused on automated testing and validation
  • Open-source maintainers seeking to ensure contributions meet quality standards

Use cases

  • Automating code review for AI-generated code in agent-assisted development
  • Ensuring code quality and security before merging agent-produced code
  • Reducing cognitive load of reviewing every line of code from an agent
  • Validating that code strictly meets a given specification through comprehensive checks

Strengths

  • Evidence-based approach with multiple check types (tests, types, lint, coverage, mutation, property-based, real execution, supply chain, suite health)
  • Agent-agnostic: works with any coding agent that follows plain markdown instructions
  • Includes a demo rate limiter that caught a real bug missed by tests, showing practical effectiveness
  • Open-source with easy installation via npx or manual copy, and permissive MIT license

Considerations

  • Relies on the agent to self-grade honestly (the rules try to prevent cheating, but it's not foolproof)
  • Cannot prove that the SPEC covers all important aspects; human oversight is still needed for specification completeness
  • Adoption requires setting up the skill and gauntlet tools; the full gauntlet may be heavy for simple fixes

README quick start

Installation

Description

An old coder's strategy for the agent era: don't read the code — make it run the gauntlet. Evidence-first development skill for coding agents, inspired by Uncle Bob.

Related repositories

Similar projects matched by category, topics, and programming language.

makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
859
deerwork-ai
Featured
deerwork-ai GitHub avatar

deer-workflow

An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.

AI & Machine LearningLarge Language Models
312