Pawl 是一个以注册表为事实依据的验证与自主研究框架,确保基于智能体的开发只根据已验证的进展前进,并将成功与诚实失败记录在可读的 CSV 账本中。

Stars

92

7 天增长

暂无数据

Fork 数

0

开放 Issue

0

开源协议

暂无数据

最近更新

2026-07-13

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它直接解决了基于智能体编程的关键缺陷——会话遗忘——通过提供持久且可查询的记忆,包含预冻结的验收门、依赖关联的注册表以及作为一等结果的诚实失败,并在包含 590 条目的大规模案例研究中证明了零数据损坏。

适合谁使用

  • 在生产代码库中使用 AI 编码智能体(如 Cursor、OpenHands)的团队
  • 构建软件项目自主实验循环的研究人员
  • 希望拥有可重现、可审计开发记录的开源维护者
  • 运行多个并行智能体会话并需要协调与完整性的组织

典型使用场景

  • 在同一代码库中并行运行多个智能体会话,避免重复工作与状态损坏
  • 将失败的实验记录为诚实失败,永久阻止对死胡同的重新探索
  • 将功能实现管理为带有预实现成功标准的可证伪声明
  • 设置自主研究循环,智能体在限定的编辑范围内迭代,并仅通过官方门控提升

项目优势

  • 零外部依赖(仅使用 Python 标准库),通过复制一个文件夹并编写一个配置文件即可采用
  • 经过实战检验:18 天内 590 条目,4–5 个并行智能体,零注册表损坏
  • 通过陈旧 PID 接管实现注册表锁定,支持单机上安全的并发智能体会话
  • 诚实失败作为一等结果,明确命名缺失的能力并通过依赖边永久阻塞死胡同

使用前须知

  • 需要初始设置:复制文件夹、编写配置文件、创建大局文档和跟踪项
  • 对于小型项目或单人项目,声明/门控纪律可能带来额外开销
  • 团队需要学习注册表作为事实依据以及预冻结验收门的工作流程,存在学习曲线

README 快速开始

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

项目描述

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

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo
精选
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 与机器学习AI 智能体
2,390
slvDev
精选
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 与机器学习大语言模型
1,960
littledivy
精选
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 与机器学习
1,482