Pawl is a registry-as-ground-truth verification and autonomous research framework that ensures agent-driven development only advances on verified progress, recording both successes and honest negatives in a machine-readable CSV ledger.

Stars

92

7-day growth

No data

Forks

0

Open issues

0

License

No data

Last updated

2026-07-13

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It directly addresses the critical flaw in agent-based coding—session amnesia—by providing a durable, queryable memory with frozen acceptance gates, dependency-linked registry, and first-class honest negatives, proven in a large-scale 590-claim case study with zero corruption.

Who it is for

  • Teams using AI coding agents (e.g., Cursor, OpenHands) in production codebases
  • Researchers building autonomous experimentation loops for software projects
  • Open-source maintainers who want reproducible, auditable development records
  • Organizations running multiple parallel agent sessions needing coordination and integrity

Use cases

  • Running parallel agent sessions on the same repository without duplicated work or corrupted state
  • Recording failed experiments as honest negatives that permanently block re-exploration of dead ends
  • Managing feature implementation as falsifiable claims with pre-implementation success criteria
  • Setting up autonomous research loops where an agent iterates within scoped edit boundaries and promotes only via the official gate

Strengths

  • Zero dependencies beyond Python standard library—adopt by copying one folder and writing a config file
  • Battle-tested with 590 claims over 18 days across 4–5 parallel agents with zero registry corruption
  • Registry-locking with stale-PID takeover enables safe concurrent agent sessions on one machine
  • Honest negatives are first-class results, naming missing capabilities and blocking dead ends via dependency edges

Considerations

  • Requires initial setup effort: copying the folder, writing a config file, and creating the big-picture document and tracks
  • The claim/gate discipline may introduce overhead for very small or single-contributor projects
  • Learning curve for teams unfamiliar with registry-as-ground-truth and frozen acceptance gates as part of the development workflow

README quick start

Pawl

Registry-as-ground-truth verification & autonomous research framework for agent-driven development.

Coding agents don't remember. Every new session starts blind: what was already proven, what failed and why, which dead ends were closed for good — gone, buried in chat scrollback and stale plan documents. So agents re-try known failures, re-explore settled questions, and report "done" for work that no gate ever verified. Pawl fixes this by making progress itself a machine-readable artifact: every meaningful change is a claim with acceptance gates frozen before implementation, a CSV registry — not plans, not dashboards, not memory of a conversation — records what is actually implemented, and failures are written down as honest negatives that name the missing capability and permanently block the dead end. Like the mechanism it is named after — the small catch that lets a ratchet wheel turn forward but never slip back — Pawl makes verified progress the only direction the record can move. The origin project ran 590 claims through it in 18 days with 4–5 parallel agent sessions: 404 verified, 167 honest negatives, zero corrupted records (see the case study).

Works for any kind of software project — web app, library, ML project, CLI tool. Pure Python standard library, zero dependencies: adopt it by copying one folder and writing one small config file.

Why "Pawl"?

A pawl is the small catch in a ratchet mechanism — the part that engages the teeth of a ratchet wheel and lets it turn forward one click at a time, but blocks any backward slip. That is the whole metaphor: agent sessions should advance only on verified progress, and known dead ends should stay closed instead of being re-explored every time someone opens a fresh chat.

The name is also a nod to karpathy/autoresearch (March 2026), which uses the same ratchet idea for a single training file: keep improvements, discard regressions, one scalar, one budget. Pawl generalizes that loop to a whole repository — many concurrent claims, per-claim edit scopes, a persistent dependency-linked registry, and honest negatives promoted into the record instead of silently reset away.

Shopware & Agentic Commerce Lab

Pawl is maintained and open-sourced by [Agentic Commerce Lab](https://github.com/agentic-c

Description

Registry-as-ground-truth verification & autonomous research framework for agent-driven development.

Related repositories

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

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482