Git Standard¶

Objetivo¶

Definir o padrão oficial de uso do Git nos repositórios do ambiente hauxtech.

Identidade¶

Todo commit deve usar:

user.name  = arecomarcelo
user.email = marcelo.areco@hotmail.com

Fluxo real (trunk-based)¶

Os produtos hauxtech (CRM, ERP, Time, Infra, Stock, People, Planner AI, Assets) trabalham em um único branch main, sem branches de feature de longa duração — confirmado no histórico real dos repositórios. Cada commit vai direto para main e o deploy é disparado a partir dele (manual via alias *-deploy, ou CI/CD nos produtos que têm pipeline, como este portal de documentação).

flowchart LR A[Commit em main] --> B[predeploy: build/lint/testes] B --> C[deploy: build da imagem] C --> D[Produção — VPS Contabo]

Não criar branches feature/*/fix/* sem necessidade — o padrão real é commitar incrementalmente em main.

Mensagens de commit¶

Idioma¶

Sempre Português (Brasil).

Conteúdo¶

Nunca incluir co-autoria ou referência a assistentes de IA na mensagem.

Formato real observado¶

Mistura de Conventional Commits (docs:, fix:, style:) com mensagens descritivas por sprint/US, como praticado nos produtos reais:

fix: corrige renderização do frontmatter e aplica identidade visual da marca

SP10, US12.008 + US12.009: fecha o MVP em 100% — tag v1.0.0

Auditoria Final (com-auditoria-final): 2 ALTAS + 1 MÉDIA + 1 BAIXA corrigidas, 0 CRÍTICA

Prefira o prefixo Conventional Commits (feat, fix, docs, style, refactor, test, chore) quando a mudança for atômica; use a notação de sprint/US quando o commit fechar um item de planejamento rastreável.

Regras obrigatórias¶

Nunca git push --force para main sem autorização explícita do usuário.
Nunca --no-verify, --no-gpg-sign ou qualquer bypass de hook sem pedido explícito.
Sempre git status antes de qualquer comando destrutivo (reset --hard, checkout ., clean -f).
Preferir git add <arquivos> explícito a git add -A/git add . para evitar incluir segredos por acidente.
Nunca commitar .env, credenciais ou chaves — mesmo sob pedido explícito, alertar antes.

Hooks¶

Produtos com .githooks/ (ex.: pre-commit que sincroniza memórias de .claude/memory/ para o repositório) devem ativar o path uma vez por máquina:

git config core.hooksPath .githooks

Objetivo Final¶

Histórico de commits legível em português, rastreável por sprint/US quando aplicável, sem branches paralelos desnecessários e sem operações destrutivas não autorizadas.