Skills · Claude Code · Agent Skills

O histórico é permanente: o gate roda antes do push — sem negociação.

Trunk-based, Conventional Commits, PR pequeno, commits assinados e segredo commitado tratado como público. O erro se corrige à frente, nunca reescrevendo o que já foi publicado.

v0.2.1Disciplina · Fluxo gitgithub.com/schematizeme/skill-git

Mantido por Lucas Andrade

schematize-git · v0.2.1bash
$ schematize install git
GitHub →baixar skill (.zip)/git-help · github.com/schematizeme/schematize-cli

Pisos inegociáveis

Não se desligam "pra ir mais rápido". Lista completa na skill.

GitHub é a fonte da verdade

Commit e push na hora; a cópia local nunca diverge do publicado.

Trunk-based e Conventional Commits

Main sempre verde, branches curtas, histórico linear e commits atômicos no padrão Conventional Commits 1.0.0.

PR pequeno

Revisável em cerca de 15 minutos, com descrição que responde o quê, como testou, risco/rollback e onde olhar.

Nunca reescrever o publicado

Sem force push em main, release ou tags; erro publicado se corrige com git revert. A única exceção é remover segredo ou dado pessoal.

Segredo commitado: rotacionar primeiro

Reescrever o histórico não desfaz o vazamento; nunca --no-verify, com secret scanning e pre-commit ativos.

Main protegida no servidor

Ruleset com force push bloqueado, histórico linear, PR, status check do gate e revisão de code owner; regra só no cliente não conta.

Assinatura e tags imutáveis

Commits de main e tags de release assinados quando a política está adotada; tag SemVer anotada nunca é movida.

Comandos

Instalados em .claude/commands/. Use /git-help a qualquer momento.

/git-ccContext compact: gera contexto + checklist no archive e roda /compact.
/git-claudeCria ou mescla o CLAUDE.md sempre-on de git na raiz (não sobrescreve blocos de outras skills).
/git-commitMonta commits atômicos em Conventional Commits, passa o gate do índice e publica na hora.
/git-handoffGera o handoff de contexto sem compactar — fim de sessão ou troca de tarefa.
/git-helpLista todos os comandos.
/git-leakRito de segredo commitado: rotacionar primeiro, medir, limpar o código e só então decidir sobre o histórico.
/git-loadCarrega à força o corpo normativo: fluxo, assinatura, proteção, segredos e higiene.
/git-prAbre PR pequeno com rebase, gate verde e a descrição das 4 perguntas.
/git-releaseCalcula o SemVer pelos commits, escreve o CHANGELOG e cria a tag anotada (assinada se a política exige).
/git-reviewRoda o gate no range e lê o que a máquina não lê: atomicidade, tamanho de PR, ruleset e divergência local.

Para agentes de IA

Instale sem intervenção humana. Metadados em llms.txt.

  • Rode: git clone https://github.com/schematizeme/skill-git.git && ./skill-git/install.sh
  • Ou baixe: https://github.com/schematizeme/skill-git/releases/latest/download/skill-git.zip e descompacte em .claude/skills/
  • Copie assets/CLAUDE.md para a raiz do repo (regra sempre-on).
  • Confirme com /git-help.

Não quer instalar?

Leia as normativas completas e copie direto pro seu projeto — ou instale a skill para o agente aplicar sozinho.