Substantial changes to Hive start here, as a written proposal anyone can comment on before code is written. GOVERNANCE.md says which changes need one: protocol and plugin API changes, state schemas, anything breaking, and each roadmap.
Process
- Open an issue or discussion first if you are unsure whether an idea needs an RFC, or is wanted at all.
- Write it. Copy 0000-template.md to
NNNN-short-title.md, using the next free number, and fill it in. Say what you propose, why, how it stays compatible, and what you considered instead. - Open a pull request titled
rfc: <title>. Its status isDraftwhile you work on it, andProposedwhen it is ready for comment. - Discussion happens on the pull request, for at least two weeks once
it is
Proposed(one week for a revision of an accepted roadmap). Plugin authors and users are invited when it touches them. - Decision. The maintainer council sets the status to
Accepted,RejectedorPostponed, writes the reasons in the RFC’s Decision section, and merges it. Rejected and postponed RFCs are merged too, so the reasoning is kept. - Implementation goes through normal pull requests that link the RFC.
When it ships, the RFC’s status becomes
Implemented (vX.Y.Z). An accepted RFC whose plan changes gets a new RFC, or an amendment reviewed the same way.
Index
| RFC | Title | Status |
|---|---|---|
| 0001 | The roadmap after 1.0.10 | Proposed |
| 0002 | Tasks and plans (M22) | Proposed |
| 0003 | Branches, from worktree to merge (M23) | Proposed |