Skip to main content

Dreamineering Symbols

How can an agent compress shared meaning without losing the decoder?

Dreamineering Symbols are the readable home for DML and A&ID notation. DML is the wire-format language. A&ID is the diagram grammar. Both compress DDL terms so agents can coordinate with less token cost and less ambiguity.

In the OKF meaning graph, symbols compress a DDL concept without replacing it. The graph should always be able to expand a symbol back to a named concept and a readable route.

Why This Exists

The one-person-company problem is not a lack of tools. It is translation loss:

  • memory lives in one place.
  • processing happens in another.
  • operating action happens somewhere else.
  • the owner still has to dig for the answer.

Dreamineering uses OKF as the portable floor, then adds an incompressible symbol layer on top. A symbol is useful only when it transfers wisdom: the next human or agent can expand it, see the decision-rights, run the loop, and leave proof.

The local stack is:

OKF page -> DDL term -> DML code -> A&ID symbol -> CLI action -> receipt

That is the difference between a note system and an operating system. The symbol is not decoration. It is a compressed instruction with a decoder and a proof path.

Symbol Families

Agent symbols:

  • digital agent.
  • human authority.
  • physical actor.
  • orchestrator.
  • human-in-the-loop boundary.

Instrument symbols:

  • alarm.
  • controller.
  • gate.
  • monitor.
  • recorder.
  • selector.
  • transmitter.
  • validator.

Loop symbols:

  • closed loop.
  • cascade.
  • open action.
  • learning return.
  • feedforward path.

Decision symbols:

  • pass.
  • fail.
  • timed condition.
  • event condition.
  • quality threshold.
  • approval condition.
  • kill condition.

Operating Rule

A symbol is valid only when the reader can expand it back to a DDL term.

Use symbols when compression helps coordination. Use prose when the reader lacks the decoder.

Use the CLI or platform only after the symbol can survive expansion:

symbol -> term -> route -> authority -> action -> receipt

If any step breaks, the symbol is not yet a language primitive. It is private shorthand.

Checks

  • The symbol has one expansion.
  • The expansion maps to a DDL term.
  • The family is clear.
  • The authority level is explicit when action can affect spend, identity, or trust.
  • The CLI or platform action is known when the symbol asks an agent to act.
  • The receipt shape is known when the symbol claims proof.
  • Unknown symbols fail closed.

Failure Modes

  • Pretty diagram — the symbol looks useful but does not govern action.
  • Undecoded pack — compressed text saves tokens but loses meaning.
  • Authority gap — action symbols omit who can approve or override.
  • Collision — one mark points at two meanings.
  • Tool costume — a workflow looks like an operating system because it uses agents, but the symbol cannot expand into an auditable action.

Context

Questions

Which symbol needs a better decoder?

  • Can the reader expand the symbol?
  • Does the symbol change an action?
  • Is authority visible?
  • Does the family prevent collision?
  • Should this be prose instead?