# Pawl: Verifiable progress for agent-driven development

> Pawl makes progress in agent-driven development machine-readable: every change is a claim with acceptance gates frozen before implementation.

- Source: https://www.agentic-commerce.sh/en/lab/pawl/
- Author: Stefan Hamann
- Updated: 2026-11-18
- Language: en

When agents write software, the question of what is actually finished becomes important. Pawl answers it with a registry instead of summaries: every change is a verifiable claim.

| Context | Shopware Agentic Commerce Lab |
| --- | --- |
| Status | Lab project |
| Repository | [github.com/agentic-commerce-lab/pawl](https://github.com/agentic-commerce-lab/pawl) |
| Checked on | 18 November 2026 |

## How Pawl works

- A change starts as a claim: a falsifiable sentence with thresholds.
- The acceptance gates are frozen before implementation begins.
- A CSV registry records what is actually implemented.
- Failures are written down as honest negatives instead of being deleted.

## Where the name comes from

A pawl is the small catch in a ratchet. It lets the wheel turn forward one tooth and keeps it from slipping back. That is how progress should be secured: one step at a time, with no silent regression.

## Get started

Pawl consists of Python tools that you copy into your repository or keep as a sibling checkout. The first step creates the project files.

```
python3 $TOOLS/init_project.py my-project --plans-dir docs/plans
```
