0xwilliamortiz/ratchet

411 stars · Last commit 2026-07-31

Your agent reads the rules. This checks whether it followed them.

README preview

# Ratchet

*Your agent reads the rules. This checks whether it followed them.*

[![license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](LICENSE)
[![node](https://img.shields.io/badge/node-%3E%3D20-111111?style=flat-square)](package.json)
[![tests](https://img.shields.io/badge/tests-115-111111?style=flat-square)](tests)

A ratchet turns one way. Complexity in your codebase goes down or stays flat,
unless someone deliberately turns it the other way and writes down why.

---

## The problem

Every minimalism ruleset for coding agents is an open loop. You inject *prefer
the standard library, do not add dependencies, keep the diff small*, the model
reads it, and then nothing checks whether any of it happened.

Compliance is assumed. When the model drifts, which it does over a long

View full repository on GitHub →