branch-workflow

Enforces Git branch naming, validation, and lifecycle management.

8|2|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/bradtaylorsf/alphaagent-team --skill branch-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-workflow
Source: https://github.com/bradtaylorsf/alphaagent-team/tree/main/plugins/aai-core/skills/branch-workflow
Command: npx skills add https://github.com/bradtaylorsf/alphaagent-team --skill branch-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the chaos of inconsistent Git branch naming, validation, and lifecycle management, ensuring smoother collaboration and reducing merge conflicts.

Core Features & Use Cases

  • Enforces Naming Conventions: Guides users to adopt clear, ticket-ID-based branch names (e.g., feature/AUTH-123-oauth-login).
  • Protects Key Branches: Prevents direct commits to critical branches like main, develop, and staging.
  • Defines PR Targeting: Establishes clear rules for which branches should be merged into others.
  • Use Case: A development team uses this Skill to ensure all new features are branched correctly, preventing accidental commits to production and streamlining the pull request process.

Quick Start

Create a new feature branch named 'feature/PROJ-456-user-authentication'.

Frequently Asked Questions about branch-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce Git branch naming conventions for my team?

You standardize Git branch naming by applying patterns like `{type}/{ticket-id}-{description}` to ensure consistent ticket tracking. Enforcing these conventions reduces merge conflicts and streamlines pull request validation across the team.

What is the best way to prevent direct commits to protected Git branches?

The best way to prevent direct commits to protected Git branches is to define branches like `main` and `develop` as protected. Establishing strict pull request targeting rules ensures all code changes are reviewed before merging.

How do I automate ticket ID extraction from Git branch names?

Automate ticket ID extraction by validating branch names against a predefined convention like `feature/AUTH-123-oauth-login`. Automated checks parse the branch string to extract the ticket ID, facilitating seamless project tracking.

Can I define specific pull request target rules for different branch types?

Yes, you can define specific pull request target rules by establishing clear mappings for which branches should merge into others. This prevents accidental merges into production and streamlines the pull request process for different branch types.

Why does inconsistent Git branch naming cause merge conflicts?

Inconsistent Git branch naming causes collaboration chaos by making it difficult to track changes and validate branch origins. Standardizing branch lifecycle management reduces merge conflicts and ensures smoother collaboration across teams.