RFC draft
A short written proposal — problem, motivation, the shape of a solution, alternatives considered, and what success looks like. Lives in a doc, not a meeting.
- 01Problem statement, in two sentences max
- 02Sketch of the proposed solution, with mockups or token diffs
- 03Alternatives considered and rejected, with one line per rejection
- 04Migration impact (codemod feasible? breaking?)
- Owner
- Proposer (any contributor)
- Reviewers
- Design system lead + one senior reviewer per discipline
Design review
The proposed visual artifact gets checked against the system: token contract, density, motion vocabulary, accessibility floor. Happens against the Figma frame and the MCP context, not on a Zoom call.
- 01Token contract — does the design use only tokens that exist?
- 02Accessibility floor — contrast, focus, motion preferences
- 03Pattern fit — does this belong as a component, a pattern, or a one-off?
- 04Voice and content — does the copy match the system's vocabulary?
- Owner
- Design system lead
- Reviewers
- One senior designer + accessibility reviewer + the proposer
Tech review
Engineering feasibility, API surface, performance impact, and the codemod plan. The codemod ships with the review: if a change can't be codemoded, the change gets reshaped.
- 01API surface — prop names, controlled vs uncontrolled, composition pattern
- 02Performance — bundle delta, render cost, virtualization needs
- 03Codemod plan — concrete script that migrates existing usages
- 04Versioning — major / minor / patch and the migration window
- Owner
- Frontend lead
- Reviewers
- Design system engineer + one consumer-team engineer
Ship
Final sign-off, PR opened, codemod published, changelog entry written, consumer teams notified. Adoption tracking begins on day one.
- 01PR with the component code, story, docs page, and codemod
- 02Changelog entry — what changed, why, migration path, deprecation window
- 03Adoption signal — internal announcement to consumer teams + slack
- 04Tracking — usage dashboard updated, first-week adoption monitored
- Owner
- Design system engineer
- Reviewers
- Two component reviewers + one consumer-team check