# rogerwilco

> rogerwilco is a Python library and protocol (RW1) that puts three program-run checks around an AI agent's irreversible actions, after aviation's readback: a job travels as one typed line; the line is checked against the approved record before it is sent; the tool that acts states exactly what it will do, and that statement is checked before it runs; what it did is checked afterwards. `pip install rogerwilco`. Standard library only. Apache 2.0 licence.

Use it when an agent pays, changes bank details, sends an external email, deletes or deploys: anything that cannot be undone. The receiving model needs only a short legend in its prompt.

## Integrate

- [Integration guide](https://rogerwilco.crox.io/quickstart.md): install, the three checks with runnable code, the two-phase tool, profiles, the HTTP API, a brief for a coding agent
- [Everything in one file](https://rogerwilco.crox.io/llms-full.txt): the guide, the skill and the full protocol, for a model doing the integration
- [Runnable example](https://github.com/afieldofdreams/rogerwilco/blob/main/examples/payment.py): a payment with all three checks

## Reference

- [Protocol spec](https://rogerwilco.crox.io/spec): grammar, the nine message types, cancel and expiry, slots, the five-tier readback, checks before and after an irreversible act, profiles
- [Skill](https://rogerwilco.crox.io/skill): the instructions an agent follows to use rogerwilco
- [Legend](https://rogerwilco.crox.io/legend?profile=pay): the text to put in a receiving model's prompt
- [HTTP API](https://rogerwilco.crox.io/openapi.json): OpenAPI for the hosted checks, no key

## Evidence

- [The tests, one at a time](https://rogerwilco.crox.io/): what was tested and what each check caught
- [Research](https://rogerwilco.crox.io/research): nine pre-registered studies, every figure with its interval

## Optional

- [What a line is](https://rogerwilco.crox.io/lines)
- [Profiles](https://rogerwilco.crox.io/profiles)
- [Demo](https://rogerwilco.crox.io/demo)