freshness-contract

Decides whether cached evidence remains trustworthy using a volatility-class decision table.

14|1|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/allemaar/open-skills --skill freshness-contract-allemaar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: freshness-contract
Source: https://github.com/allemaar/open-skills/tree/main/skills/freshness-contract
Command: npx skills add https://github.com/allemaar/open-skills --skill freshness-contract-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents often reuse previously read files, banked test results, or worker reports without knowing whether intervening writes, environment changes, or elapsed time have invalidated them. This Skill replaces guesswork with a categorical decision table that outputs reuse, spot-check, re-verify, or accept-labeled-risk for any piece of prior evidence. ## Core Features & Use Cases - Volatility Classification: Assigns each artifact to a class (stable, write-coupled, env-coupled, clock-coupled, or report) based on observable properties, not confidence feelings. - Signal-Based Decision Table: Checks intervening writes, named invalidators, decision leverage, and discriminator availability, then applies a first-match-wins table with a restrictive default for unclassified artifacts. - Inline Output Record: Emits a compact freshness record (artifact, class, signals, decision) directly inside the report or decision that consumed the evidence. - Use Case: Before relying on a test result from two hours ago to approve a release, run the contract to determine whether the result is still valid, needs a cheap spot-check, or must be fully re-verified. ## Quick Start Ask the agent to run /freshness-contract on the evidence you are about to reuse, for example by saying "is this test result from earlier still current enough to base the release decision on?"

Frequently Asked Questions about freshness-contract

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I know if cached evidence is still valid before reusing it?

Classify the artifact by volatility (stable, write-coupled, env-coupled, clock-coupled, or report), then check observable signals like intervening writes and named invalidators. The decision table maps the situation to reuse, spot-check, re-verify, or accept-labeled-risk.

What is the difference between freshness-contract and double-check?

freshness-contract decides whether old evidence still counts before reuse, while double-check re-verifies the content of a single claim. When the table returns re-verify, double-check is the targeted re-read that satisfies it.

Does freshness-contract use time-to-live values to judge staleness?

No. The skill deliberately ships no TTL numbers because any fixed age threshold would be invented. It routes decisions by artifact class and observable events, so age alone never justifies reuse or refusal.

When should I re-verify a worker or subagent report?

Any report that is load-bearing for a decision must be re-verified regardless of age, because a report is an account of state, not state itself. Reports used only for orientation can be reused if labeled as reports.

What happens when an artifact does not fit any volatility class?

Unclassified artifacts hit the default row and must be spot-checked, with the kind classified before any next reuse. Conflicting or ambiguous signals also resolve restrictively to re-verify.