Skip to main content

DDL — Dreamineering Domain Language

What language lets humans and agents point at the same thing without translation loss?

DDL is the human-readable wrapper for the agent language. It names the concepts agents use when they plan, act, record, and improve. Use AISL in protocol and schema contexts. Use DDL on readable agent surfaces.

Core Terms​

Agent:

  • an accountable actor that reads intent, uses instruments, acts inside authority, and emits receipts.
  • avoid: treating every software tool as an agent.

Instrument:

  • a thing that measures, gates, records, selects, transmits, or warns.
  • avoid: using instrument as a generic name for any page or script.

Receipt:

  • a proof trail that records what happened, under which scope, with which result.
  • avoid: treating logs as receipts when they do not prove authority or outcome.

Loop:

  • the feedback path from intent through action, proof, learning, and the next intent.
  • avoid: using loop when a one-way task has no learning return.

Capability:

  • a declared job an agent can perform under known input, output, authority, and proof rules.
  • avoid: calling a desire a capability before proof exists.

Delegation:

  • the decision-right layer that says act alone, ask first, escalate, or refuse.
  • avoid: letting permission hide inside tool access.

Density​

DDL sits between narrative prose and wire-format symbols:

  • prose explains the idea.
  • DDL names the idea.
  • DML compresses the idea.
  • diagrams place the idea in a system.

The same concept should survive each density change.

Checks​

  • A term has one canonical meaning in this context.
  • An overloaded term names its domain.
  • Avoid aliases are visible when drift is likely.
  • A symbol or code links back to a readable term.
  • New capability names use the same language as the source contract.

Failure Modes​

  • Dialect split — two pages use different names for the same agent concept.
  • Overloaded term — one word means different things without a qualifier.
  • Brand drift — DDL and AISL get treated as competing standards.
  • Decoder gap — symbols exist without a readable term.

Context​

Questions​

Which word would cause the next agent to choose the wrong action?

  • Is the term canonical?
  • Is the domain clear?
  • Is the avoid list clear?
  • Is the compressed code linked?
  • Is the name stable enough to build on?