Skip to content

Schemas and Prompts

vmblu is a collection of tools, formats and prompts designed to build, understand and maintain software created with coding agents.

It serves two roles simultaneously:

  • guiding the coding agent while constructing the system
  • enabling the human to understand, verify and control what has been built

The vmblu toolkit can be roughly divided into:

  • Schemas — formal descriptions of the architecture and the data exchanged between application components.
  • Prompts — structured instructions that define how the coding agent designs and builds the system, including the roles it assumes during development.
  • Commands — mechanical utilities such as project initialization, application generation, test harness creation and source profiling.
  • Graphical Editor — an interactive representation of the architecture as interconnected nodes, allowing navigation, inspection and modification.
  • Runtime — a message-switching layer between components, supporting inspection, sandboxing and enforcement of runtime permissions.
  • MCP support — exposes selected parts of the system as tools for agents, making natural language interfaces straightforward to build.

vmblu is open source. All formats, prompts and tools are available for inspection and modification. The schemas and prompts can also be inspected using the links below:

The vmblu schemas

  • blu.schema.json : the schema description of the architecture file. Source of truth.
  • blue.annex.md : an explanation about the semantics of the architecture file.
  • viz.schema.json : a file generated by the vmblu editor that contains representation details about architecture. Not critical, can be regenerated.
  • prf.schema.json : The schema for the results of a full parse of the source code.

The vmblu prompts