Mizan
Docs

Mizan

Evidence-tiered auditing and preregistration methodology, packaged as a Claude skill.

Repository · Latest release · Kıyas · İskele · ux-mizan · the family


English

Mizan (Turkish/Arabic: the scale) turns a rigorous experimental-science discipline into a portable tool for evaluating any claim set — an AI-generated summary, a project report, a year-in-review, a codebase, a PRD — and for maintaining living hypothesis registries.

Its core commitments: every claim gets an evidence tier, with no untagged assertions. Thresholds are locked before results, or the HARKing risk is declared rather than silently absorbed. Every hypothesis carries a refutation condition — a claim that cannot fail is not audited, it is decorated. Refuted entries are never deleted. A surprising positive waits for its symmetric control before it gets a headline. And three confirming anecdotes are selection bias; a scored prediction record is evidence.

Worked examples (in the repository): a registry that passes every rule, the portability runs that test whether the discipline survives a hostile setup, and auditing a document whose source you cannot reach — where the failure mode is not refusal but tier laundering.

The registry schema has an LLM-free validator (rules R1–R28, plus a non-blocking warning channel). It enforces the mechanical invariants and nothing else: semantic judgement stays with a human or a frontier model, which is rule R7 itself.

Kanıt-katmanlı denetim ve önkayıt metodolojisi — bir Claude skill’i olarak paketlenmiş.

Depo · Son sürüm · Kıyas · İskele · ux-mizan · aile sayfası


Türkçe

Mizan (terazi/ölçü), titiz bir deneysel-bilim disiplinini herhangi bir iddia setini değerlendirmek ve canlı hipotez registry’leri sürdürmek için taşınabilir bir araca dönüştürür.

Temel taahhütler: her iddia bir kanıt katmanı alır, etiketsiz iddia olmaz. Eşikler sonuç görülmeden önce kilitlenir; mümkün değilse HARKing riski sessizce soğurulmaz, açıkça beyan edilir. Her hipotez bir çürütme koşulu taşır — başarısız olamayan iddia denetlenmiş değil, süslenmiştir. Çürütülen girdiler silinmez. Sürpriz pozitif, manşetten önce simetrik kontrolünü bekler. Ve üç doğrulayıcı anekdot seçilim yanlılığıdır; puanlanmış bir tahmin kaydı kanıttır.


The family

İskele builds · Mizan weighs · Kıyas generates · ux-mizan measures experience. İskele turns a vague project intent into an executable delivery kit. Mizan audits claims and maintains preregistered registries. Kıyas generates the candidates Mizan weighs, and a Mizan registry’s refuted entries flow back to Kıyas as negative constraints. ux-mizan carries the same discipline into experience, where the evidence is behavioural rather than documentary — the loop closes.

Where it starts: with something you already have. A document, an AI conversation, an article, a rough idea — but equally a repository, a legacy codebase, or a project already under way: modes 3–5 exist for exactly those, and in an undocumented project the audit report is the documentation. What an earlier mode produced — a gap map, a bug registry, a gated PRD — re-enters the same way.

And the entry is not a one-time event. While the loop is turning, a new idea, a new document, a fresh piece of code can enter at Mizan on any turn; the registry is append-only so that late material joins what is there instead of restarting it. Mizan is the entry, and everything after it is the loop.

All four, and how they hand off →

Aile

İskele kurar · Mizan tartar · Kıyas üretir · ux-mizan deneyimi ölçer. İskele belirsiz bir proje niyetini koşulabilir bir teslim kitine çevirir. Mizan iddiaları denetler ve önkayıtlı registry’ler tutar. Kıyas Mizan’ın tarttığı adayları üretir; Mizan registry’sindeki reddedilen kayıtlar da negatif kısıt olarak Kıyas’a geri akar. ux-mizan aynı disiplini kanıtın belgesel değil davranışsal olduğu alana taşır — döngü kapanır.

Nereden başlar: elinizde zaten olan bir şeyle. Bir doküman, bir YZ sohbeti, bir makale, ham bir fikir — ama aynı ölçüde bir repo, bir legacy kod tabanı ya da hâlihazırda süren bir proje: 3–5. modlar tam bunlar için var ve dokümansız bir projede denetim raporunun kendisi dokümantasyondur. Önceki bir modun ürettiği şey — boşluk haritası, bug registry’si, kapıdan geçmiş bir PRD — aynı yoldan yeniden girer.

Giriş de tek seferlik değildir. Döngü dönerken yeni bir fikir, yeni bir doküman, taze bir kod parçası her turda Mizan’a girebilir; registry’nin yalnızca-eklenir olmasının sebebi budur — sonradan gelen malzeme var olanı sıfırlamaz, ona katılır. Giriş Mizan’dır, ondan sonrası döngüdür.

Dördü ve nasıl devrettikleri →