evidence-freshness
Skill33 starsChanged 36 days agoApache-2.0View on GitHub
Bind a check or action to the input snapshot it actually used. Use before relying on cached verification, consuming a reviewed batch, acting while inputs may change, or retrying an operation with an ambiguous result.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- okgrit/done-is-a-claimword for word, first seen Nov 8, 2026
Other versions1 project uses a version of this.
Word for word · 1
- okgrit/done-is-a-claim★ 33100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository16 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- acceptance-designSkill
- checking-deliverySkill
- collecting-worker-resultsSkill
- debugging-with-evidenceSkill
- executing-plansSkill
- implementing-with-testsSkill
- planning-changesSkill
- public-claimsSkill
- reading-measurementsSkill
- responding-to-reviewSkill
- resuming-workSkill
- reviewing-changesSkill
- using-done-is-a-claimSkill
- whose-redSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Before the run, hash the selected inputs or a manifest of them.
- Distinctive: line 21
Run the named check against that snapshot.
- Distinctive: line 29
When a result gates a consequential action, use isolated immutable inputs or coordination that prevents concurrent writes.
- Distinctive: line 34
Use the same bytes and identifiers that were checked: the frozen candidate list, tested artifact or exact revision.
- Distinctive: line 37
If anything relevant changed, stop that action and reconcile or recheck.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Evidence freshness
Evidence remains a statement about its measured snapshot. It supports a later decision only to the extent that the decision uses that snapshot and relevant conditions. These are operational safeguards, not a new incident record.
Pin what the check consumes
- Identify the input tree and relevant configuration, dependencies, datasets, generated inputs, flags and environment. Record the revision and dirty state; a commit alone does not describe uncommitted or untracked input.
- Before the run, hash the selected inputs or a manifest of them. Say what the selection excludes; matching a few hashes cannot certify the whole repository or an external service. Freeze batch lists into a separate snapshot rather than checking a list that remains open for append.
- Run the named check against that snapshot. Record command, outcome, time and evidence location. Retain the tested inputs or enough identifiers to reproduce them without treating a log summary as the input identity.
- Compare the revision, dirty state and selected hashes after the run. Changed inputs make the result ambiguous for the new tree. A formatter or fixer that mutates its inputs does not certify its resulting tree; run acceptance again on the stable result. Distinguish produced outputs from changed inputs.
- Equal before/after hashes can miss edits made and restored during a run. When a result gates a consequential action, use isolated immutable inputs or coordination that prevents concurrent writes; hashes alone are not a lock.
Consume the reviewed snapshot
Use the same bytes and identifiers that were checked: the frozen candidate list, tested artifact or exact revision. Verify them again immediately before the action, including the current destination and ownership where relevant. If anything relevant changed, stop that action and reconcile or recheck; do not silently substitute a newer list, branch tip or rebuilt artifact. Where a race can still occur after the comparison, use an atomic conditional update or equivalent expected-revision mechanism. Otherwise report the limit and coordinate the action rather than claiming the comparison eliminated it.
Reconcile ambiguous retries
A timeout or nonzero exit may occur after an output or state change was created. Inspect the destination, durable records and any existing successor before retrying. Reuse an operation identity when the system supports it; otherwise establish whether the first attempt took effect and avoid duplicates.
Report the snapshot checked, snapshot consumed, relevant differences and any unresolved race. Historical evidence stays valid for its old snapshot; a claim about current state needs evidence appropriate to that state.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

