VIVACITY

DOCS / PUBLIC GUIDE

Change one thing.
Watch what happens.

A practical guide to how Vivacity turns observations into testable explanations. This is a working discovery runtime, not a claim of final truth.

01 / OVERVIEW

A discovery loop should keep the evidence visible.

Vivacity helps a person choose observations, compare possible rules, and find the next safe test. It separates what a model predicted from what the environment later returned.

Current scope The live demo studies bounded generated systems. A result can be useful without being universal, novel, or proven true.

02 / THE HIDDEN SYSTEM

Imagine a box with one knob and one meter.

You can turn the knob. You can read the meter. You cannot open the box. Vivacity changes the input carefully and asks which explanation best predicted the meter.

INPUTx?yMEASUREMENT

03 / THE DISCOVERY LOOP

Six small actions, repeated.

  1. 01

    Look

    Start with measurements selected for the question. The hidden rule is not available to Vivacity.

  2. 02

    Propose

    Try the existing executable hypotheses before treating a new explanation as necessary.

  3. 03

    Predict first

    Each candidate records what it expects before the next measurement can be read.

  4. 04

    Change one thing

    Choose a safe input where the candidates disagree, then run the bounded experiment.

  5. 05

    Compare

    Measure the consequence and keep the prediction miss with the evidence record.

  6. 06

    Rethink

    Reject inadequate ideas. Create a new structure through abduction only when the current pool fails.

04 / STATE, ACTION, OBSERVATION

State is what you inspect before you act.

An observation is only a partial view of a larger state. An action proposes a transition. Execution determines the next state that can be observed.

St+atESt+1S_t + a_t \longrightarrow E \longrightarrow S_{t+1}

This is a conceptual map. The actual executor may be a simulator, a solver, or another bounded environment.

Orbital state with a planet and candidate trajectories
Orbital state

Position and velocity persist together. A maneuver is an action. The next recorded position is the observation.

Flow state with streamlines around an obstacle
Flow state

A field shows what is moving where. Changing one condition lets competing flow explanations face the same evidence.

Contact action with a robotic gripper applying force to an object
Contact action

A grip command meets a material surface. Force, slip, or hold becomes an observed consequence, not a claim.

05 / WHO DOES WHAT?

Ideas come from one side. Judgment comes from evidence.

IDEA MAKER
Frontier reasoning modelSuggests structurally different explanations. Its words never count as scientific evidence.
TRANSLATOR + CALCULATOR
Mechanistic runtimeChecks allowed math, fits unknown values, and turns valid models into predictions.
REALITY CHECKER
World model or environmentReceives an intervention and returns a measurement. In this demo it is a hidden simulation.
LAB NOTEBOOK
Evidence ledgerKeeps the prediction, intervention, measurement, uncertainty, and update in order.

06 / HYPOTHESES AND ABDUCTION

A leading idea can still be wrong.

Vivacity compares how well the current executable ideas predicted the evidence, while accounting for uncertainty and complexity. Support is conditional on the available candidate set.

When old ideas fail

Vivacity can create a new mathematical structure through abduction. That new idea receives no special treatment. It must compile, predict, and survive falsification.

What support means

Support is not proof. It can change with a more discriminating experiment, new data, or a better competing model.

07 / SCOPE AND LIMITS

A working system with explicit limits.

  • No claim of physical validation. The public demo uses generated environments and bounded interactions.
  • No model is called proven true. The evidence is conditional on selected observations and tested explanations.
  • No unshown integrations are implied. A visible executor and an evidence record are required before a runtime claim is made.
Run a discovery

08 / PLAIN WORDS

A small science dictionary.

Observation
Something measured after an action or from the starting state.
State
The inspectable record of conditions, relations, and time before the next decision.
Hypothesis
A possible executable explanation that can still be wrong.
Prediction
What a hypothesis says should happen before the result is known.
Abduction
Creating a new possible explanation after the current ideas are inadequate.
Falsification
Trying to find evidence that would show an explanation is wrong.