O Jeito Rust

Use rustfmt como forma compartilhada automática e mantenha decisões de API, algoritmo e contrato em uma revisão separada.

Leia grupos e motivos de lints, confirme o risco no domínio e use refactor ou exceção local justificada sem tratar Clippy como oráculo.

Leia código, spans, notas e ajuda de rustc, reduza um reprodutor mínimo e confirme se a proposta preserva o contrato.

Caracterize o comportamento, refatore uma dimensão de ownership e prove valores e forma da API com testes e requisitos de fonte.

Escolha nomes de crates, módulos, tipos e funções que comunicam o contrato no ponto de uso sem repetição nem vagueza.

Use new, Result e Default para construir valores válidos sem esconder falhas nem inventar padrões para dados transparentes.

Escolha borrow, mutação e ownership na assinatura conforme a função lê, altera, armazena ou consome o valor.

Modele configuração parcial em builders, valide em build e use Default somente para escolhas válidas.

Separe a organização interna da superfície suportada com módulos privados, pub(crate), pub use e internals selados.

Implemente From para conversões infalíveis, receba Into quando isso ajuda o chamador e respeite significado, coherence e SemVer.

Use TryFrom e erro tipado para validar na construção, manter invariantes depois do sucesso e separar regras locais de contexto externo.

Escolha AsRef para visões baratas, Borrow para consultas equivalentes e Deref somente para acesso transparente semelhante a ponteiros.

Use newtypes para separar significados, preservar invariantes, escolher traits e criar pontos locais de coherence sem prometer ABI indevida.

Modele sequências estáveis com type-state, transições que consomem self e métodos por estado, mas prefira enum para fluxos dinâmicos.

Projete erros públicos com variantes ligadas às decisões do chamador, dados estáveis, non_exhaustive e uma política consciente de SemVer.

Implemente Display e Error::source sem duplicação, acrescente contexto onde a operação é conhecida e apresente a cadeia uma vez.

Use thiserror para gerar Display, Error e From, sem delegar à macro a escolha de variantes, dados públicos ou política de conversão.

Use anyhow em aplicações que relatam falhas, preserve erros tipados nas bibliotecas e acrescente contexto de operação sem lavar a causa.

Escolha Result para falhas esperadas e panic para invariantes violadas ou suposições irrecuperáveis, com expect que declara a prova.

Escreva doc comments como contratos verificáveis de erros, panics e safety, com exemplos completos que rustdoc mantém compiláveis.

Teste comportamento público, bordas e propriedades sem acoplar a suíte à estrutura privada que uma refatoração precisa mudar.

Implemente IntoIterator para coleção própria, referência e referência mutável com itens e lifetimes corretos, sem criar iteradores desnecessários.

Escolha Fn, FnMut ou FnOnce pela quantidade de chamadas e pelo consumo das capturas, sem impor bounds que o corpo não usa.

Reduza a superfície unsafe, escreva contratos Safety verificáveis e exponha wrappers seguros que preservam validade, alinhamento, aliasing e lifetimes.

Meça alocações, clones, complexidade, cache, latência e throughput antes de mudar uma API ou reduzir clareza em um hot path.

Projete APIs async com ownership através de await, cancelamento seguro, Send somente quando necessário, trabalho bloqueante isolado e tarefas estruturadas.

Caracterize comportamento público, registre invariantes e refatore uma dimensão por vez sem transformar goldens em testes de detalhes privados.

Revise caminhos, assinaturas, traits, enums, features e MSRV, e use SemVer para administrar o risco de mudanças públicas.

Execute uma auditoria limitada de API pública com evidências para tipos, erros, docs, testes, unsafe, desempenho, async e compatibilidade.