agentleFS
kalshamsikalshamsi/fable-discipline-skills/skills/assumption-audit/SKILL.md

assumption-audit

Skill0 starsChanged 4 months agoMITView on GitHub

Before finalizing any analysis, recommendation, or decision made under incomplete information, surface the load-bearing assumptions, tag each as supported or unsupported by the given evidence, and stress-test the conclusion against the weakest one. Use this whenever you are asked "should we do X", to recommend or advise, to compare options, or to make strategy, hiring, budget, planning, prioritization, or operational judgment calls — even when the request doesn't mention assumptions or uncertainty. If the answer would rest on anything not directly stated in the given information, this skill applies.

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 3 edited versions we read keep these.

  • 3

    Distinctive

    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
  1. Distinctive:

    Only then finalize. Keep what was given (data, quotes, stated constraints) visibly distinct from what you inferred, so no inference …

    line 26
  2. Distinctive:

    Never narrate your own diligence ("I carefully checked...", "having verified the assumptions...").

    line 41
  3. Distinctive:

    Keep length proportionate to the task — the audit sharpens the answer, it does not pad it.

    line 47

“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Assumption Audit

Conclusions under incomplete information rest on assumptions, and the ones that go unstated are the ones that fail silently. Intelligence tradecraft treats this as a standard failure mode: analysts fill gaps with plausible-seeming beliefs, then present the conclusion as if it followed from evidence alone. The fix is not more caution — it is making the assumptions visible before the conclusion hardens, so the reader (and you) can see exactly which unverified belief the recommendation would die with.

Process

  1. Draft your reasoning, then — before writing the conclusion — list the assumptions it actually depends on. Load-bearing only: an assumption belongs on the list if the conclusion changes when it fails.
  2. Tag each assumption supported (follows from information you were given or can verify) or unsupported (plausible, but nothing provided confirms it). Be strict: "usually true in general" is not support from the given information.
  3. Identify the weakest load-bearing assumption and ask what the recommendation becomes if it is false. If the answer flips or degrades badly, the conclusion must say so — that sensitivity is part of the answer, not a footnote.
  4. Only then finalize. Keep what was given (data, quotes, stated constraints) visibly distinct from what you inferred, so no inference silently borrows the authority of evidence.

What this looks like

  • Hiring: "Recommend the senior candidate" rests on "budget covers senior comp" (unsupported — no budget was given); if false, the recommendation flips to candidate B.
  • Market analysis: flat sales + a competitor's launch suggests lost share — but "the decline started after their launch" is an inference; the data only shows Q3 totals.
  • Code migration: "cut over this weekend" assumes traffic is low on weekends (unsupported — no traffic data provided); if false, the rollback window disappears.

Output rules

  • Never narrate your own diligence ("I carefully checked...", "having verified the assumptions..."). The audit shows in the work product — the tagged list, the sensitivity statement — not in self-description.
  • The audit happens before and while producing the answer; only its results appear in the output, and only where they matter. A simple question with solid givens may need just one line noting the key unsupported assumption.
  • Keep length proportionate to the task — the audit sharpens the answer, it does not pad it.
  • State the recommendation's sensitivity to the weakest assumption in plain terms: what changes, and how the reader could check the assumption cheaply if they can.

Grounding: CIA, A Tradecraft Primer: Structured Analytic Techniques (2009), Key Assumptions Check; ICD 203, IC Analytic Standards — distinguish underlying intelligence from assumptions and judgments.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.