get-shit-done/.github/workflows/branch-naming.yml

name: Validate Branch Name

on:
  pull_request:
    types: [opened, synchronize]

permissions: {}

jobs:
  check-branch:
    runs-on: ubuntu-latest
    timeout-minutes: 1
    steps:
      - name: Validate branch naming convention
        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
        with:
          script: |
            const branch = context.payload.pull_request.head.ref;

            const validPrefixes = [
              'feat/', 'fix/', 'hotfix/', 'docs/', 'chore/',
              'refactor/', 'test/', 'release/', 'ci/', 'perf/', 'revert/',
            ];

            const alwaysValid = ['main', 'develop'];
            if (alwaysValid.includes(branch)) return;
            if (branch.startsWith('dependabot/') || branch.startsWith('renovate/')) return;
            // GSD auto-created branches
            if (branch.startsWith('gsd/') || branch.startsWith('claude/')) return;

            const isValid = validPrefixes.some(prefix => branch.startsWith(prefix));
            if (!isValid) {
              const prefixList = validPrefixes.map(p => `\`${p}\``).join(', ');
              core.warning(
                `Branch "${branch}" doesn't follow naming convention. ` +
                `Expected prefixes: ${prefixList}`
              );
            }