Skill: Hypothesis Engine (Working-Theory Ledger)

Maintain an append-only JSONL ledger scoring investigative hypotheses against evolving evidence.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/rjonhaas/SIFTics --skill skill-hypothesis-engine-working-theory-ledger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill: Hypothesis Engine (Working-Theory Ledger)
Source: https://github.com/rjonhaas/SIFTics/tree/main/skills/hypothesis-engine
Command: npx skills add https://github.com/rjonhaas/SIFTics --skill skill-hypothesis-engine-working-theory-ledger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, scripts/hypothesis_score.py, and includes scripts (resource) components.

What problem does it solve?

It prevents investigation anchoring bias by maintaining an explicit, continuously updated ledger of 2–3 working theories that can be rescored and retired as new evidence arrives.

Core Features & Use Cases

  • Append-only hypothesis ledger: Records hypothesis evolution in JSONL at analysis/hypotheses.jsonl without rewriting prior entries.
  • Evidence-driven scoring: Uses scripts/hypothesis_score.py to compute confidence mechanically from weighted supportive and contradictory signals.
  • Operational-period maintenance: Re-scores active hypotheses at each operational period boundary, retires low-confidence items, and ensures at least one adequately supported hypothesis exists.
  • Contradiction surfacing: Detects mutually exclusive high-confidence hypotheses and surfaces contradictions in the COP’s Contradictions table.
  • Report-ready reasoning: Produces artifacts that downstream reporting can render into narrative explanations of how conclusions were reached.

Quick Start

Invite the Investigation Section Chief to invoke this skill at case start and then at every operational period boundary to keep hypotheses scored, retired, and updated based on the latest COP findings.

Frequently Asked Questions about Skill: Hypothesis Engine (Working-Theory Ledger)

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

FAQPage Schema
How do I score investigative hypotheses against new evidence during DFIR triage?

You can score investigative hypotheses by using a mechanical confidence computation script that evaluates weighted supportive and contradictory signals. This approach rescores active theories at each operational period boundary, ensuring your DFIR triage reasoning reflects the latest evidence.

What is the best way to prevent investigation anchoring bias in digital forensics?

Preventing investigation anchoring bias requires maintaining an explicit working-theory ledger of 2–3 active hypotheses. By continuously rescoring these theories against new evidence and retiring low-confidence items, you force objective evaluation over subjective assumptions.

How do I track hypothesis evolution without overwriting prior forensic analysis entries?

You can track hypothesis evolution without overwriting history by using an append-only JSONL ledger. This format records every hypothesis update at analysis/hypotheses.jsonl sequentially, preserving the full investigative reasoning chain for later review.

Can Python3 scripts detect contradictory high-confidence hypotheses in incident response investigations?

Yes, Python3 scripts can detect mutually exclusive high-confidence hypotheses by applying defined confidence thresholds. When contradictions are found, they are surfaced directly in the Common Operating Picture's Contradictions table for incident response review.

When should I retire a low-confidence working theory during an operational period update?

You should retire a low-confidence working theory during an operational period update when its mechanical confidence score drops below defined thresholds due to stale-decay rules or contradictory evidence. The system then ensures at least one adequately supported hypothesis remains active.

Does hypothesis scoring require manual calculation of confidence levels from contradictory signals?

No, hypothesis scoring does not require manual calculation because it uses hypothesis_score.py to compute confidence mechanically. The script automatically evaluates weighted supportive and contradictory signals to generate objective confidence levels.