Schemas and agent guidance

vmblu uses versioned schemas and agent instructions to keep application architecture explicit, inspectable, and maintainable. The canonical documents live in the vmblu repository on GitHub; this page links to those sources directly instead of keeping copies in the website repository.

The active CLI and schema version is 1.12.2, as declared in cli/package.json. Earlier schema versions remain available in the cli/context directory for projects that have not yet migrated.

Architecture and visual model

• blu.schema.json — schema for the *.mod.blu architectural source of truth.
• blu.annex.md — semantic rules and clarifications that cannot be expressed fully in JSON Schema.
• viz.schema.json — schema for the generated *.mod.viz visual-layout document.

Systems, protocols, and source integration

• sys.schema.json — schema for *.sys.blu system configurations that connect multiple vmblu applications.
• protocol.schema.json — schema for explicit inter-application protocol definitions.
• prf.schema.json — schema for generated *.src.prf source profiles grouped by model node.

Agents and capabilities

• capabilities.schema.json — schema for generated agent capability manifests.
• agents.v1.json — schema for vmblu agent configuration.
• vmblu agent workflow (SKILL.md) — current instructions for coding agents working with vmblu projects and artifacts.
• Agent integration guide — supported capability, profile, and agent-interface behavior.

Project-specific instructions are stored in each project's .vmblu/vmblu.prompt.md; they complement the shared workflow above and are not a replacement for the versioned schemas.

Testing and security

• model-test.schema.json — schema for model-level test definitions.
• test-report.schema.json — schema for generated model-test reports.
• security-event.schema.json — schema for runtime security events.

The complete active context directory is the authoritative index for schema version 1.12.2.