Skip to content

Instantly share code, notes, and snippets.

View matthewsinclair's full-sized avatar

Matthew Sinclair matthewsinclair

View GitHub Profile
@pmarreck
pmarreck / MFIC.md
Last active July 3, 2026 14:34
MFIC — Mechanically-Falsifiable Independent Control: a discipline for enforced tests and runtime checks that keep agents honest

MFIC — Mechanically-Falsifiable Independent Control

A discipline for checks that can't be fooled by the same mistake that produced the work.

Abstract. When the author of a piece of work — an LLM, or a human moving fast — can be confidently and silently wrong, the usual defenses fail quietly: a test written from the same mistaken assumption as the code passes while the code is broken. MFIC is the class of check that escapes this trap, defined by four properties that must all hold at once. It is Mechanical (cases swept by machine, not hand-picked, so nothing is silently omitted), Falsifiable (each case genuinely bites when the work is wrong, on inputs you couldn't pre-arrange to pass), Independent (its verdict comes from the contract or the data — a source the producer doesn't control — which is segregation of duties restated for software), and a real Control (it holds the authority to block the bad outcome, not merely log it). This is the COSO / Sarbanes-Oxley model of internal co

@pmarreck
pmarreck / time_awareness_hook.md
Created June 24, 2026 02:23
Give LLM agents (Claude in this case, but may be adaptable to others) an awareness of time in an unobtrusive way.

Giving Claude Code a sense of time (rate-limited, low-noise)

A self-contained recipe. Read this one file and you can reproduce the whole mechanism from scratch — a human or another LLM, knowing nothing else.


1. The problem

An LLM agent has no clock. It only knows what is in its context window.