How a workflow becomes analyzable
SDVM does not start from a finished diagnosis. It starts from observable workflow activity and asks, step by step, what can be represented, checked, and computed without inventing missing context.
-
Foundation
Traces and working artifacts
Execution logs, tool results, messages, and changing work objects from agentic runs.
-
Foundation
Stages, cycles, handoffs, and events
Break the workflow into observable structure rather than treating a run as a single opaque blob.
-
Foundation
Common evidence representation
Convert heterogeneous traces into a shared form that deterministic computation can consume.
-
Maturing
Evidence-sufficiency checks
Ask whether the available material is enough for each intended computation before producing a result.
-
Foundation
Deterministic variable computation
When contracts are met, compute the thirteen canonical measures reproducibly.
-
Maturing
Later longitudinal and combinatorial interpretation
Track patterns across cycles and combine signals into bounded hypotheses — product direction, not a completed external product.
Minimal workflow vocabulary
- Stage
- A functional phase of the workflow — for example plan, execute, review, or verify. A stage is not necessarily a separate agent.
- Cycle
- A recognizable evaluation window — a bounded pass through work, review, or correction — distinct from an entire end-to-end run when the workflow repeats or revisits phases.
- Handoff
- A transfer of context, responsibility, or artifacts between stages, roles, agents, or tools.
- Event
- An observable occurrence recorded in the trace, such as a message, tool call, stage transition, or checkpoint.
- Artifact
- A work object that can change during execution — a plan, analysis, code draft, decision record, or response — not merely its file wrapper.
- Evidence
- Observable, provenance-bearing material that can support or limit a specific computation. Recording an event is not the same as having sufficient evidence.
These structures are not only inputs to later diagnosis. They also expose design choices that can make a workflow easier to inspect, correct, and strengthen while it is still being built.
Evidence sufficiency
Different measures need different kinds of supporting material. A trace may show that activity happened without showing enough chronology, identifiers, revision links, or context to support a particular computation. SDVM is designed to report that limit — for example as insufficient, partial, or undefined — rather than fill the gap with inference. Sufficiency for a computation is not product readiness.
What the deterministic core calculates
When input contracts are met, the core computes thirteen fixed measures — the canonical variables. They are lower-level, reproducible signals. They are not, by themselves, an integrated diagnosis, a recommendation, or proof of cause.
The four dimensions below are design vocabulary for reading coupling health. The thirteen variables are the operational measures with primary design associations to those dimensions in the current technical design. Several signals can also inform other dimensions; the grouping is not an exclusive or closed taxonomy.
- Synchrony — coordination geometry and friction across roles, stages, and handoffs.
- Depth — continuity of anchors, context, and options across cycles.
- Vulnerability — whether uncertainty is registered, explored, and allowed to update the work.
- Metacognition — whether the workflow runs explicit correction rounds and whether revisions are adopted and later associated with change.
See the 13 canonical variables
Plain-language descriptions of what each deterministic computation measures. The variables are organized below by their primary design association. Some variables can also inform other dimensions; the grouping is not an exclusive or closed taxonomy. No formulas, thresholds, weights, or private scoring logic are published here.
Primary association: Synchrony
- Turn-/Stage-Overlap Entropy (TOE)
- How participation is distributed across roles or stages within a cycle or observation window.
- Repair Rate (RR)
- How often repair or friction moves appear within a cycle or comparable window.
Primary association: Depth
- Anchoring Ratio (AR)
- Share of decisions that are explicitly tied to evidence or identifiers.
- Context Carryover Integrity (CCI)
- Whether decisions and identifiers persist coherently across cycles.
- Cross-Artifact Convergence (CAC)
- Continuity across artifacts and cycles through shared anchors, IDs, decisions, and references.
- Horizon Expansion Profile (HEP)
- How the set of live options or hypotheses expands and narrows across cycles.
Primary association: Vulnerability
- Uncertainty Load (U)
- How many distinct uncertainty items are registered in a cycle or window.
- Uncertainty-to-Exploration Yield (U→E)
- Share of eligible uncertainties that lead to a qualifying exploration conversion.
- Novel Alternative Rate (NAR)
- How often non-trivial alternatives or counter-hypotheses appear.
- Revision After Evidence (RAE)
- Share of eligible evidence arrivals that trigger a qualifying structural revision.
Primary association: Metacognition
- Meta-Round Frequency (MRF)
- How often explicit meta-correction rounds occur relative to eligible cycle opportunities.
- Revision Adoption Rate (RAR)
- How often proposed revisions are adopted among eligible cases.
- Revision Effectiveness (REff)
- Whether adopted revisions are later associated with measurable change under comparable windows — not proof of cause by itself.
From signals to later diagnosis
A single run can show an event. Longitudinal analysis asks whether the same pattern persists, changes, or returns across cycles and repeated runs — and whether artifact versions and comparison windows make that reading valid. That layer is under active maturation; it is not offered as a finished external capability.
One variable rarely sustains a diagnostic hypothesis alone. Combinatorial diagnosis means combining multiple computed signals into a bounded hypothesis while preserving contrary evidence, sufficiency limits, and provenance. Correlation between signals is not causation. Example direction only: a workflow may generate many alternatives yet rarely revise decisions when new evidence appears — that combination can support a bounded hypothesis about shallow exploration, without proving why the behavior occurred.
Computed values still need a governed record that connects each signal to the observations, provenance, sufficiency status, and interpretation limits that support it — Diagnostic Evidence. Above that, the target Integrated Diagnostic Object is a governed consolidation of variables, supporting evidence, longitudinal patterns, bounded hypotheses, contrary signals, and claim limits. It is not merely a report, and it is not available as an integrated product today.
Before, after, and comparison
PRE preserves observations from a before state. POST preserves observations after a documented change. A valid DELTA requires more than subtracting two reports: the runs must be comparable, the evidence must support the same computations, and the interpretation must remain bounded. Difference is not proof of effectiveness or cause. An external PRE/POST/DELTA product contract is not available while the readiness gate remains blocked.