/git-workflow - Git Operations with Standards

Orchestrate git operations with safety checks, branch naming enforcement, and PR creation.

Usage

/git-workflow branch feature/my-feature    # Create a properly named branch
/git-workflow commit                       # Commit with conventional format
/git-workflow pr                           # Create PR with standards
/git-workflow help                         # Show this help

Arguments

$ARGUMENTS - Subcommand and options

Subcommands

branch <name>

- Create Branch

Creates a new branch with naming validation.

Valid prefixes:

feature/

bugfix/

hotfix/

chore/

docs/

refactor/

Steps:

1. Validate branch name follows convention
2. Check for uncommitted changes
3. Create and switch to new branch
4. Push with upstream tracking (optional)

Example:

/git-workflow branch feature/123-voice-pipeline

commit

- Commit with Standards

Creates a commit following conventional commit format.

Pre-commit checks (automatic):

1. Run

   /verify-clean

   - linters, tests, sensitive files
2. Run

   /docs-audit

   - documentation accuracy
3. Stage changes if needed
4. Prompt for commit message in format:

   {type}({scope}): {description}

Commit types:

feat

fix

docs

refactor

chore

test

Example output:

feat(vps): Add WordPress deployment automation

- Configure nginx reverse proxy
- Set up automated backups
- Add health check endpoint

Closes #123

pr

- Create Pull Request

Creates a PR with proper title format and linked issues.

Steps:

1. Verify branch is pushed to remote
2. Extract issue number from branch name (if present)
3. Generate PR title from commits:

   {type}: {description}

4. Create PR with summary and test plan
5. Link to issue if found

PR body format:

## Summary
- Brief description of changes

## Test Plan
- [ ] Tests pass locally
- [ ] Documentation updated
- [ ] No linting errors

Closes #123

Branch Naming Enforcement

feature/

feature/voice-pipeline

bugfix/

bugfix/auth-401-error

hotfix/

hotfix/db-connection-leak

chore/

chore/upgrade-node-22

docs/

docs/api-examples

refactor/

refactor/auth-module

Workflow Integration

1. /git-workflow branch feature/123-desc   # Start feature
2. [Development work]
3. /verify-clean                           # Check quality
4. /docs-audit                             # Check docs
5. /git-workflow commit                    # Commit changes
6. /git-workflow pr                        # Create PR

Output

Provide clear feedback at each step:

• Branch creation confirmation
• Pre-commit check results
• Commit hash and message
• PR URL when created
• Any validation warnings or errors