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 Build a validator. Read references/conversion-patterns.md.

• A rule about canonical formatting, image shape, generated output, or metadata cleanup Build a normalizer, then validate the normalized artifact.

• A repeated scaffold or generated file layout Build a generator from a manifest or explicit plan. Keep the plan editable and the scaffold shape fixed.

• A flaky environment or cross-platform failure Add runtime discovery, version checks, fixtures, and CI matrix coverage. Read references/verification.md.