Heuristic to Deterministic

Turn session learnings and repeated review heuristics into repeatable checks, normalizers, generators, fixtures, CI jobs, and hook-ready workflows.

Decision Tree

What kind of heuristic are you converting?

• A rule about required or forbidden structure Use or extend a validator. Consult references/conversion-patterns.md when artifact selection needs detail.

• A rule about canonical formatting, image shape, generated output, or metadata cleanup Reuse a normalizer where available, then verify its postconditions.

• A repeated scaffold or generated file layout Use or extend a generator from a manifest or explicit plan. Fix only the shape required by the output contract; leave incidental file organization editable.

• A flaky environment or cross-platform failure Select runtime discovery, version checks, fixtures, or CI coverage for the failure. Consult references/verification.md when proof depth needs detail.