executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
s4h-investigation-counter-hypothesisGenerates the best alternative explanations for the same observations. Use when you have a claim or explanation and want to know whether something else could explain the evidence just as well — 'could there be another explanation', 'what else could cause this', 'am I sure this isn't something else', 'steel-man the alternative', 'what would a skeptic say', '…
Independent GitHub snapshot · Automated classification · Original documentation governs
The confirmation trap is automatic: once we have an explanation, we look for evidence that supports it and stop looking for evidence that would support alternatives. Counter-hypothesis generation is the structural antidote. The process is not to argue against your explanation — it is to seriously generate the best competing explanations and then ask: given all the evidence, which hypothesis should I actually believe? The decisive test — the observation that, if run, would most clearly discriminate between hypotheses — is the product.
Step 1: State the Hypothesis Under Investigation Write out the claim or explanation you are currently working with:
Framing check: Confirm the specific hypothesis before continuing. State what you've identified — the claim being tested, what it purports to explain, and what evidence is cited for it — in one sentence, then use AskUserQuestion:
Step 2: Generate Rival Hypotheses Generate rival alternative explanations that could account for the same observations using all the strategies below. Then show the complete generated set to the user before narrowing.
Before narrowing: Show all generated rivals to the user first. Use AskUserQuestion:
Then narrow to 3–5 rivals. Each developed rival hypothesis should:
Strategies for generating rivals:
Do not construct straw man rivals. Generate the most serious version of each alternative.
Step 3: Assess Evidence Fit for Each Rival For each rival hypothesis:
Step 4: Identify the Discriminating Evidence For each pair of hypotheses (original vs. rival), ask: what single observation or piece of evidence would most cleanly rule one out?
If you already have this evidence, apply it. If you don't, name what investigation would produce it.
Step 5: Identify the Decisive Test Across all rivals, identify the single test that would do the most work:
Step 6: Rank Current Credibility Given all available evidence — including evidence for rivals — how does each hypothesis rank? Do not default to your original hypothesis unless the evidence genuinely favors it.
Before proceeding, use the AskUserQuestion tool. State your interpretation of the situation in 1–2 sentences — what is being analyzed and what the core question is — then ask:
Proceed based on their selection. If the user reframes, incorporate the correction before running any analysis.
Observations to explain: [What we're trying to account for] Current hypothesis: [The explanation being tested] Evidence currently supporting it: [What is cited in its favor]
Rival 1: [Name/Description]
Rival 2: [Name/Description] [Same structure]
[Repeat for 3-5 rivals]
| Hypothesis A | Hypothesis B | Discriminating Evidence | Status |
|---|---|---|---|
| Original | Rival 1 | [Observation that distinguishes them] | [Have it / Need to find it] |
| Original | Rival 2 | [Observation that distinguishes them] | [Have it / Need to find it] |
Test: [The single investigation that would do the most work] What it would show: [How it discriminates between hypotheses] Feasibility: [Can it be run? If not, what's the best proxy?]
The live question: [What remains genuinely uncertain and what evidence would resolve it]
Counter-hypothesis generation is not devil's advocacy. The goal is not to argue for an alternative but to seriously evaluate whether the evidence discriminates between competing explanations. Use investigation-evidence-audit to evaluate the strength of the evidence cited for the original hypothesis. Use logic-argument-validation to check whether the inference from evidence to hypothesis is valid. Counter-hypothesis is specifically about rival explanations — not about whether the evidence is good, but about whether it uniquely supports one interpretation.
After delivering this output, use AskUserQuestion to offer the next move:
/s4h-investigation-evidence-audit — Audit evidence for and against each hypothesis/s4h-probability-scenario-weighting — Weight competing hypotheses by probability/s4h-investigation-triangulation — Triangulate across hypotheses to find what holds