plugins/workflow/skills/assumption-audit/SKILL.md
Use as the mandatory evidence gate before signing off on any strategy, PRD, or business case—audits every key claim against documented sources and assigns calibrated probabilities.
npx skillsauth add joellewis/skill-library assumption-auditInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Assumption-audit is the "evidence gate" that prevents Resulting (evaluating decisions by outcomes) and Hindsight Bias (feeling something was predictable after it happened). It forces an honest accounting of what is known versus what is guessed.
NO SIGN-OFF WITHOUT VALIDATION EVIDENCE FOR EVERY KEY CLAIM
Assertions without evidence are vulnerabilities. Unaudited assumptions create fragile strategies that collapse under the first sign of volatility.
digraph assumption_audit_flow {
"Start" [shape=doublecircle];
"Step 1: Inventory Key Assumptions" [shape=box];
"Step 2: Evidence Mapping (Knowledge Tracker)" [shape=box];
"Step 3: Stress-Test (Pre-mortem)" [shape=box];
"Step 4: Probability Calibration" [shape=box];
"Gate: Claim-Evidence Match" [shape=diamond];
"Step 5: Fragility Audit (Via Negativa)" [shape=box];
"Done: Audit Passed" [shape=doublecircle];
"Start" -> "Step 1: Inventory Key Assumptions";
"Step 1: Inventory Key Assumptions" -> "Step 2: Evidence Mapping (Knowledge Tracker)";
"Step 2: Evidence Mapping (Knowledge Tracker)" -> "Step 3: Stress-Test (Pre-mortem)";
"Step 3: Stress-Test (Pre-mortem)" -> "Step 4: Probability Calibration";
"Step 4: Probability Calibration" -> "Gate: Claim-Evidence Match";
"Gate: Claim-Evidence Match" -> "Step 5: Fragility Audit (Via Negativa)" [label="matched"];
"Gate: Claim-Evidence Match" -> "Step 1: Inventory Key Assumptions" [label="mismatch"];
"Step 5: Fragility Audit (Via Negativa)" -> "Done: Audit Passed";
}
REQUIRED SUB-SKILL: using-skills — To maintain audit discipline.
RECOMMENDED SUB-SKILL: devils-advocate — To provide adversarial pressure on the assumptions.
RECOMMENDED SUB-SKILL: decision-frameworks — To structure the final sign-off.
| Thought | Reality | |---------|---------| | "We've done our research, we know this will work." | This is "definite optimism" and ignores the role of luck and hidden volatility. | | "I don't need a knowledge tracker; I remember why I chose this." | Memory is a "hindsight bias" machine that rewrites history to make you look right. | | "A pre-mortem is too negative; it will demoralize the team." | Unchecked fragility is what actually demoralizes teams when they inevitably fail. | | "The upside is so high it doesn't matter if we're slightly wrong." | Fragile systems have a "concave" downside—being "slightly wrong" can lead to total ruin. |
These thoughts mean STOP — you are about to shortcut:
databases
Use when a deliverable needs structured stakeholder sign-off before finalization—runs the pre-read, feedback-type alignment, and conflict-resolution protocol.
development
Use when you need to map who has power, who will be affected, and what motivates each party — produces a stakeholder map as an analytical artifact. This skill identifies and categorizes stakeholders; it does not persuade or influence them (use influence-architect for that).
testing
Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.
testing
Use when translating a product vision into engineering requirements—enforces the Working Backwards PR/FAQ method, requiring a customer-facing press release before any technical spec.