docs: document the draft-stage versioning rule

[JarbasAl]

Summary

Document the policy that while a spec is in Draft, the Version
field doubles as a compatibility signal with current OVOS:

• v1 = drop-in compatible
• v2 = incompatible (requires OVOS-side changes)

Compatible changes during draft fold into the current version
rather than bumping. Only incompatible features bump.

The applied consequences (already in their respective PRs):

• PR OVOS-INTENT-3 v1.1 — rename "host" to "orchestrator" #13 (INTENT-3 rename) — v1.1 reverted, folded into v1
• PR OVOS-MSG-1 v1.1 — data and context optional #15 (MSG-1 optional keys) — v1.1 reverted, folded into v1
• PR OVOS-INTENT-4 — intent and entity registration bus contract #9 (INTENT-4) — first release set to v2 (topic renames)
• PR OVOS-PIPELINE-1 — utterance lifecycle and pipeline (draft) #11 (PIPELINE-1) — first release set to v2 (passive index)

Test plan

• Confirm README Contributing section reads consistently
• Confirm CHANGELOG intro points to the new section

🤖 Generated with Claude Code

[coderabbitai]

Warning

Review limit reached

@JarbasAl, we couldn't start this review because you've used your available PR reviews for now.

Your plan currently allows 1 review/hour. Refill in 33 minutes and 48 seconds.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more review capacity refills, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than trial, open-source, and free plans. In all cases, review capacity refills continuously over time.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 167b56dd-c0f8-4f14-8f55-215d9ae024e7

📥 Commits

Reviewing files that changed from the base of the PR and between 8b418fa and 099644a.

📒 Files selected for processing (2)

• CHANGELOG.md
• README.md

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/draft-versioning-policy

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}