spec: protocol semantics changed.template: authoring templates changed.ops: operational flow changed.schema: machine-readable validation changed.rfc: proposal for future protocol or compatibility changes.
- update version where applicable;
- document migration impact;
- add changelog note;
- avoid breaking template field names without migration section.
- use
spec/RFC/README.mdwhen changing protocol semantics or compatibility expectations.
Until v1.0.0, breaking changes are allowed but must be marked clearly in PR title: [breaking].
- versioned spec entrypoint:
spec/v0.1/README.md - conformance levels:
spec/CONFORMANCE.md - spec changelog:
spec/CHANGELOG.md