spec: migrate RFCs to spec/rfcs/ with template + lifecycle doc (closes #66)#69
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #66.
Promotes the five open RFCs from "GitHub issues with the design label" to structured markdown files with frontmatter, in a dedicated directory with a documented lifecycle. Standard pattern for any language project that wants to be open to community contributions; this matches what Rust, Ethereum, Cosmos, and Bitcoin all do.
What landed
Directory + process docs
Migrated RFCs
Five proposals lifted from issue bodies into structured files:
Each gets YAML frontmatter:
```yaml
rfc: 0001
title: "Memory model for Cleave (ownership, GC, escape hatches)"
status: draft
authors: ["Cleave Labs"]
tracking: #42
created: 2026-05-23
```
The body text is unchanged from the issue. Substantive edits happen via PRs against the file going forward.
Cross-linking
Each tracking issue gets a comment pointing at its new RFC file. Discussion continues on the issue; the file is the source of truth for proposal text.
Spec index
`spec/README.md` table updated:
Why now
Five RFCs is the inflection point. Below that, GitHub issues are fine. Above, structure matters:
What this PR does NOT do
What unblocks next