formspec-companion-authoring

To author a Formspec companion spec, you draft an add-on document that attaches to a Formspec Definition while preserving core data capture and processing models. This ensures additive compatibility with the Core specification without altering existing semantics.

A Formspec companion spec is a document that adds capabilities, such as add-ons or ontology materials, to a Definition without altering core processing. You need one when expanding Formspec features while ensuring conformance with the Core specification.

Formspec schema authoring requires adherence to the schema-authoring-guide.md and spec-style-guide.md reference documents. These guides provide the conventions and structured framework needed to ensure your companion specs align with Core Formspec standards.

Structuring SKILL.md for a Formspec companion spec requires including YAML frontmatter with name and description fields. This frontmatter enforces adherence to reference guidance and ensures the companion spec is properly formatted for Formspec processing.

You can add ontology materials and references to a Formspec Definition without breaking conformance by ensuring they are purely additive. The companion spec must preserve core semantics and processing models, expanding capabilities without redefining existing data capture rules.

When authoring Formspec add-ons, you cannot redefine core Formspec semantics or alter data capture and processing models. Companion specs must remain strictly additive, meaning any changes that modify the Core specification's behavior will break conformance.