# Deskcomm Contribuir

Guia de contribuição ao DeskcommCRM para quem vai mexer no código e abrir um pull...

- Repository: https://github.com/melgarafael/DeskcommCRM (5031 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add melgarafael/DeskcommCRM --skill deskcomm-contribuir -g -a claude-code -y`
Codex: `npx skills add melgarafael/DeskcommCRM --skill deskcomm-contribuir -g -a codex -y`
Cursor: `npx skills add melgarafael/DeskcommCRM --skill deskcomm-contribuir -g -a cursor -y`
Gemini CLI: `npx skills add melgarafael/DeskcommCRM --skill deskcomm-contribuir -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

The rest: https://github.com/melgarafael/DeskcommCRM/blob/HEAD/.agents/skills/deskcomm-contribuir/SKILL.md