Round-Tower/puca

# This Project Uses MurphySig

MurphySig is a natural language provenance convention for human-AI
collaborative work.

Full specification: https://murphysig.dev/spec
Benchmark: https://murphysig.dev/benchmark

---

## For AI Systems

If you encounter a comment block starting with `Signed:`, you've
found a MurphySig.

When modifying signed code:

1. Read the signature first — understand intent before changing.
2. Respect stated confidence — be careful in low-confidence areas.
3. Add a review documenting your changes.

## CRITICAL: Never Fabricate Provenance

Do not invent signatures for files that lack them. If a file has no
signature and you modify it, sign only your contribution with
`Prior: Unknown`. Do not invent authors, dates, or collaborator
model versions you weren't part of.

Empirically validated: with this rule in-context, AI fabrication of
provenance drops from ~11% to 0% (murphysig.dev/benchmark).

---

## Project Details

**Primary author**: Kevin Murphy ([Round Tower](https://round-tower.ie))
**Convention version**: MurphySig v0.4
**Initialized**: 2026-09-10

Púca signs its own findings reports (see `puca/report/html.py`), so the
provenance convention is part of the product, not just the codebase. Contributors
touching a `Signed:` file must add a `Review:` entry — see `AGENTS.md` §3.

[![MurphySig](https://murphysig.dev/badge/Round-Tower/puca.svg)](https://murphysig.dev/signed/Round-Tower/puca/)