Deskcomm Contribuir
Guia de contribuição ao DeskcommCRM para quem vai mexer no código e abrir um pull...
Install
npx skills add melgarafael/DeskcommCRM --skill deskcomm-contribuir -g -a claude-code -y- Repository
- melgarafael/DeskcommCRM5k
- Category
- Git and review
- Updated
- 3d ago
- License
- MIT
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- Yes, review before use
What it does
Guia de contribuição ao DeskcommCRM para quem vai mexer no código e abrir um pull request, sobretudo de um fork. Use SEMPRE que a pessoa disser que vai contribuir, corrigir um bug, implementar algo, abrir ou atualizar um PR, criar uma migration, resolver conflito com a main, ou perguntar "como eu testo isso", "minha branch está atrasada?", "por que o CI ficou vermelho", e antes de qualquer commit em clone que não seja do mantenedor. É o espelho da triagem: mede ANTES do PR o que o mantenedor mede depois (branch atrasada, tripla de migration, marca do fork no diff, fragmento de release, teste que falta, prova em tela), arma os hooks de git e evita retrabalho e PR recusado.
Contribuir para o DeskcommCRM sem retrabalho
Quem contribui aqui quase nunca erra por falta de capacidade, erra por não saber a régua. A régua
existe, mas está espalhada em três documentos (CLAUDE.md, CONTRIBUTING.md e o procedimento de
triagem, com mais de 100 KB) e é aplicada depois do PR, por quem mantém. Este guia aplica a
mesma régua antes, do seu lado, para o PR chegar pronto. Taxa histórica de recusa de PR de
fork: zero. O que trava é retrabalho, e retrabalho se evita medindo.
Como você age
- Aconselha, não bloqueia. Você mede e mostra; só os hooks de git bloqueiam, e só o que é
irreversível (push na
main, migration sem a tripla). Uma pessoa que quer seguir mesmo assim segue, sabendo o que vai acontecer na triagem. - Mede na fonte, nunca copia número. A lista de checks obrigatórios, quantas specs rodam e o que o CI cobre mudam toda semana; cada afirmação vem com o comando que a produziu.
- Declara o que não mediu. Um PR que diz "não rodei o e2e porque não tenho Docker" é melhor que um que marca tudo. O mantenedor prova o que ficou faltando; a régua pública é essa.
- Sabota antes de dizer "testado". Teste que não fica vermelho quando o conserto sai não guarda nada.
Passo 0, quem está contribuindo
Este passo vem antes de trazer a main (Passo 1), então não conte com o script estar no clone:
um fork anterior a 2026-09-10 ainda não o tem, e o guia pode ter vindo da instalação global. O
comando abaixo procura o script na raiz do clone (vale de qualquer subpasta dele) e, se não achar,
nas três pastas globais em que o instalar-guias.sh põe os guias. Cole como está, de onde você
estiver:
