Skip to content

Som-Energia/SomCommonSkills / git-branch

git-branch

Verified

Crea branques de git seguint convencions de naming: IMP_, FIX_, MOD_, ADD_, etc. Trigger: Quan necessites crear una branca nova per treballar.

When to Use

Utilitza aquesta skill quan:

  • Començar a treballar en una nova feature
  • Corregir un bug
  • Fer qualsevol canvi que requerixi una branca separada

Convencions de Naming

El format és: <type>_<description>

Tipus de Branca

PrefixTipusDescripció
IMP_ImprovementMillora d funcionalitat existent
FIX_Bug FixCorrecció de bug
MOD_ModificationCanvi de comportament
ADD_AdditionAfegir nova funcionalitat
REF_RefactorRefactorització sense canvi funcional
TEST_TestAfegir o corregir tests
DOCS_DocumentationCanvis de documentació
CI_CI/CDCanvis a pipelines

Regles

  1. Descripció: 2-3 paraules en anglès, lowercase
  2. Separador: Guió baix (_) entre tipus i descripció
  3. Espais: Utilitzar guions (-) dins la descripció si cal
  4. Longitud: Màxim 50 caràcters

Workflow

Pas 1: Actualitzar main/master

git fetch origin
git pull origin main

Pas 2: Crear branca nova

git checkout -b <type>_<description>

Pas 3: Fer canvis i commit

(Utilitza la skill git-commit)

Pas 4: Fer push

git push -u origin <branch_name>

Exemples

# Nova funcionalitat
git checkout -b ADD_user_registration

# Millora
git checkout -b IMP_payment_validation

# Bug fix
git checkout -b FIX_invoice_total_calculation

# Canvi de comportament
git checkout -b MOD_renewal_process

# Refactor
git checkout -b REF_extract_partner_service

# Tests
git checkout -b TEST_contract_validation

# Documentació
git checkout -b DOCS_api_reference

Errors Comuns

ErrorCausaSolució
Branch already existsBranca ja existentCanvia el nom o elimina la branca existent
Invalid branch nameCaràcters invàlidsUtilitza només lletres, números, guions i guions baixos
Not on mainNo estàs a maingit checkout main abans de crear branca

Integració amb SDD

Aquesta skill s'utilitza a les fases:

  • sdd-propose: Per crear branca des del proposal
  • sdd-apply: Per crear branca de treball
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall