verio.dev

Schemas

Verio keeps a project’s design controls as YAML under .verio, and every file it writes names its schema on the first line:

# yaml-language-server: $schema=https://verio.dev/schema/requirements.schema.json

Editors use it to complete and validate as you type. It is there for everything else too — a script, or an agent asked to change a requirement — so that what a file is allowed to contain travels with the file rather than living only in the tool that wrote it.

project.schema.json.verio/index.yaml

The project record — what it is called, and what makes a folder a Verio project.

root.schema.json.verio/design/design.yaml

The design, and whatever part of it is not kept in a file of its own.

requirements.schema.json.verio/design/requirements.yaml

The requirements tree: user needs, requirements, specifications, tests.

architecture.schema.json.verio/design/architecture.yaml

The software architecture (IEC 62304 5.3), as sections of prose.

soup.schema.json.verio/design/soup.yaml

The SOUP list (IEC 62304), scanned from the project’s own dependencies.

risks.schema.json.verio/design/risks.yaml

The ISO 14971 analysis: each risk with its hazard, harm, estimates and controls.

release.schema.json.verio/releases/1.0.0.yaml

One version: the interval it covers, and the changes it carries, keyed by identifier inside it. unreleased.yaml is the one being worked on.

risk.schema.json*.risk.yaml

A standalone risk analysis, for a file that keeps only that.

These are the schemas the tool itself validates against, served from the same source — not a copy that can drift from it.