sourcecontrol

name	SourceControl
description	Git workflow automation including commits, branch management, and PR creation with conventional commits and clean commit rules. USE WHEN commit, git commit, create branch, pull request, PR, push, git workflow, conventional commit, stage changes, commit message.

SourceControl

Professional git workflow automation with conventional commits, mode-aware interaction, ticket reference parsing, and clean commit rules.

Customization

Before executing, check for user customizations at: ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/SourceControl/

If this directory exists, load and apply any PREFERENCES.md configurations (commit templates, branch naming conventions, protected branches). If not, proceed with defaults.

Prerequisites

PAI must be installed. Check ~/.buddy/.pai-version. If missing, inform user: "PAI is required. Run /pai:setup to install."

Workflow Routing

Workflow	Trigger	File
Commit	"commit", default invocation, git changes	Workflows/Commit.md
CreateBranch	"branch", "create branch", spec folder ref	Workflows/CreateBranch.md
CreatePR	"PR", "pull request", "create PR"	Workflows/CreatePR.md

Auto-Detection

Default invocation routes to Commit workflow.

Configuration

The skill reads configuration from .claude/hooks.json (config section) when available:

• config.git.auto_push — Auto-push after commit
• config.git.branch_protection — Protected branches list
• config.git.conventional_commits — Enforce conventional format
• config.git.sign_commits — GPG signing

Examples

Example 1: Simple commit

User: "/buddy:commit"
-> Detects changes, stages, generates conventional commit message
-> Uses AskUserQuestion for confirmation
-> Creates commit, offers to push

Example 2: Commit with ticket reference

User: "/buddy:commit SDO-123 --yes"
-> Auto-yes mode, stages all changes
-> Generates: "SDO-123: feat(auth): add JWT validation"
-> Commits and pushes automatically

Example 3: Create pull request

User: "/buddy:commit PR"
-> Routes to CreatePR workflow
-> Ensures changes committed, generates PR description
-> Creates PR via gh CLI, returns URL