Schema Reference

The FLUX schema is one JSON Schema file per released version — normative, immutable once published, served at a stable URL:

https://agenticstiger.github.io/flux/schema/flux-schema-0.5.0.json
https://agenticstiger.github.io/flux/schema/flux-schema-latest.json
  • Anatomy — the envelope, the kind-branch structure, the shared $defs grammar, and what the offline validator adds.
  • The Nineteen Kinds — generated per-kind field reference, straight from the schema.
  • Versions — every released version, its window, and its URL.
  • Changelog — human-written diffs, one per version pair.

Editor integration

# yaml-language-server: $schema=https://agenticstiger.github.io/flux/schema/flux-schema-0.5.0.json

Validation is two layers

JSON Schema alone cannot express cross-document truths. The reference validator (scripts/validate.py) adds: reference resolution (kind-typed, no dangling links), sum checks (lifecycle mix, experiment weights), set membership (taxonomy transitions, blueprint edges), agentPolicy bounds, and full FLUID seam conformance — all offline.