decay
Manage evidence freshness by identifying stale decisions and providing governance actions
By neolabhq · 1,042 installs
npx skills add neolabhq/context-engineering-kit --skill decay
Source repository · Upstream listing
Evidence Freshness Management
Manages evidence freshness by identifying stale decisions and providing governance actions. Implements FPF B.3.4 (Evidence Decay).
Key principle: Evidence is perishable. Decisions built on expired evidence carry hidden risk.
Quick Concepts
What is "stale" evidence?
Every piece of evidence has a valid until date. A benchmark from 6 months ago may no longer reflect current system performance. A security audit from before a major dependency update doesn't account for new vulnerabilities.
When evidence expires, the decision it supports becomes questionable not necessarily wrong, just unverified.
What is "waiving"?
Waiving = "I know this evidence is stale, I accept the risk temporarily."
Use it when:
You're about to launch and don't have time to re run all tests
The evidence is only slightly expired and probably still valid
You have a scheduled date to refresh it properly
A waiver is NOT ignoring the problem it's explicitly documenting that you know about the risk and accept it until a specific date.
The Three Actions
Situation Action What it does
Evidence is old but decision is still good Refresh Re run the test, get fresh evidence
Decision is obsolete, needs rethinking Deprecate Downgrade hypothesis, restart evaluation
Accept risk temporarily Waive Record the risk acceptance with deadline
Action (Run Time)
Step 1: Generate Freshness Report
1. List all evidence files in .fpf/evidence/
2. For each evidence file:
Read valid until from frontmatter
Compare with current date
Classify as FRESH, STALE, or EXPIRED
Step 2: Present Report
Step 3: Handle User Actions
Based on user response, perform one of:
Refresh
User: "Refresh the redis caching evidence"
1. Navigate to the hypothesis in .fpf/knowledge/L2/
2. Re run validation to create fresh evidence
Deprecate
User: "Deprecate the auth module decision"
1. Move hypothesis from L2 to L1 (or L1 to L0)
2. Create deprecation record:
3. Move the hypothesis file:
Waive
User: "Waive the benchmark until February"
1. Create waiver record:
Natural Language Usage
You don't need to memorize evidence IDs. Just describe what you want.
Example Workflow
WLNK Principle
A hypothesis is STALE if any of its evidence is expired (and not waived).
This is the Weakest Link (WLNK) principle: reliability = min(all evidence). One stale piece makes the whole decision questionable.
Audit Trail
All actions are logged:
Action What's Recorded
Deprecate from layer, to layer, reason, date
Waive evidence id, until date, rationale, date
Files created in .fpf/evidence/ :
deprecate {hypothesis} {date}.md
waiver {evidence} {date}.md
Common Workflows
Weekly Maintenance
Pre Release
After Major Change