From d759b728e9954019e6ad0d59a924a778ce8ccbb0 Mon Sep 17 00:00:00 2001 From: Ty Date: Mon, 27 Jul 2026 16:07:27 +0000 Subject: [PATCH] docs: deterministic vs inference matrix --- design/det-vs-inf.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 design/det-vs-inf.md diff --git a/design/det-vs-inf.md b/design/det-vs-inf.md new file mode 100644 index 0000000..2544584 --- /dev/null +++ b/design/det-vs-inf.md @@ -0,0 +1,20 @@ +# Deterministic execution vs model inference + +Implementable boundary so install/upgrade/policy never depend on model compliance and skills stay testable offline. + +| Concern | Deterministic (code / CLI) | Inference (main or vision aux) | +|---------|----------------------------|--------------------------------| +| Install Docker, Compose, pins | Yes | No | +| `nemohermes onboard`, policy set, channels add, inference set, snapshot, rebuild | Yes | No | +| Provider/MCP process start, health probes | Yes | No | +| SaaS JSON → domain objects; stock thresholds; appointment gap math | Yes | No | +| Template fill for standard SMS/email skeletons | Yes | Optional paraphrase | +| “What’s important on my board today?” | Facts from tools | Ranking and wording | +| Draft tone in owner’s voice | Style pack constraints | Generation | +| Photo/video understanding | Media validation | Vision aux | +| Refuse pay / silent send / publish | OpenShell + skill hard fail | Model should refuse; not relied on alone | +| Confirm-to-remember persistence | Write only after structured confirm | Propose text to remember | +| Upgrade pull/migrate/recreate | Yes | No | +| Owner-facing “run this in a terminal” | **Forbidden** | SOUL/skills must not invent shell recipes | + +Unit tests cover the deterministic column without a live model.