O que carve faz?
Primitiva de branch monolítico → PRs empilhados alinhados a tickets. YAML centrado em planos, tags de backup atestadas com BLAKE3, porta de hash de árvore, divisões de commits transversais, política JIRA por equipe via .carve.toml. Irmão pré-PR do vitrine. Teoria em theory/CARVE.md, habilidade em blackmatter-claude/skills/carve/SKILL.md.
Visão Geral
Carve permite que equipes de desenvolvimento transformem um branch monolítico contendo várias mudanças em uma sequência de PRs empilhados, onde cada PR corresponde a um ticket JIRA específico. O processo é orientado por um arquivo YAML de plano que define como os commits devem ser agrupados e ordenados.
Funcionalidades Principais
- YAML Centrado em Planos: Defina a estrutura desejada dos PRs em um arquivo
carve-plan.yaml. - Tags de Backup BLAKE3: Cada operação de divisão gera tags de backup atestadas com BLAKE3 para garantir integridade e rastreabilidade.
- Porta de Hash de Árvore (Tree-hash Gate): Valida a árvore de commits antes de executar a divisão, prevenindo divisões inválidas.
- Divisões de Commits Transversais: Suporte para dividir commits que afetam múltiplos componentes ou diretórios.
- Política JIRA por Equipe: Configure convenções de nomenclatura e regras de JIRA específicas para cada equipe via
.carve.toml.
Exemplo de Uso
# Inicializar um plano Carve
carve init --ticket PROJ-123,PROJ-124
# Executar a divisão baseada no plano
carve split --plan carve-plan.yaml
# Verificar integridade das tags
carve verify --tag v1.0-carve-backup
Configuração .carve.toml
[team.frontend]
jira_prefix = "FE"
convention = "kebab-case"
[team.backend]
jira_prefix = "BE"
convention = "snake_case"
Integração com Agentes
Carve é projetado para ser usado por agentes de IA como Claude Code, Cursor e Codex. O agente pode:
- Gerar planos YAML automaticamente baseados nos tickets JIRA.
- Executar divisões e verificar a integridade com BLAKE3.
- Validar a árvore de commits antes de prosseguir.
Teoria e Documentação
Para entender os fundamentos teóricos, consulte theory/CARVE.md. Para a implementação prática como habilidade, veja blackmatter-claude/skills/carve/SKILL.md.
Licença
MIT