Skip to Content
GovernanceRFC process

RFC process

Governance · 03

Sem processo, o design system vira coleção de exceções.

Nem toda mudança precisa de RFC. Mudanças que alteram contrato público, comportamento padrão ou gramática visual precisam ser discutidas antes do código.

Quando RFC é obrigatório

MudançaRFC?
Novo componente, pattern ou template públicoSim
Nova categoria de tokenSim
Remoção ou rename de API públicaSim
Mudança de comportamento padrãoSim
Política nova de acessibilidade, voice ou motionSim
Bug fix sem mudança de contratoNão
Prop opcional retrocompatívelNão
Ajuste interno de CSS sem efeito visívelNão
Documentação, exemplos e testesNão

Lifecycle

EstadoCritério
DraftProblema e proposta inicial
ReviewImpacto, alternativas e riscos avaliados
AcceptedOwner e plano de entrega definidos
ImplementedPR mergeado e documentação publicada
DeprecatedSubstituto e prazo publicados
RemovedRemoção em release compatível com semver

Template mínimo

# RFC: título ## Problem ## Proposal ## Alternatives considered ## Impacted surfaces ## Accessibility and auditability ## Migration plan ## Rollout and validation

Semver

TipoExemplo
PatchCorreção visual sem mudança de contrato
MinorNovo componente ou token aditivo
MajorRemoção, rename ou quebra de comportamento público

Deprecation policy

  • API pública deprecated fica disponível por pelo menos 2 minor releases.
  • Docs devem mostrar substituto e prazo.
  • Build pode alertar antes de bloquear.
  • Remoção exige changelog claro e PR de migração quando possível.

DS Council

TemaAprovação
Token públicoDesign + frontend
AcessibilidadeDesign + frontend + produto
IA/assistênciaProduto + design + tech
Breaking changeCouncil completo
Last updated on