Git Workflows Skill

Provides comprehensive Git version control capabilities for the Golden Armada AI Agent Fleet Platform.

When to Use This Skill

Activate this skill when working with:

• Git commands and operations
• Branching strategies
• Commit management
• Pull requests and merges
• Repository configuration

Quick Reference

Basic Commands

```bash

Status and info

git status git log --oneline -10 git diff git diff --staged

Staging

git add git add . git add -p # Interactive staging

Committing

git commit -m "message" git commit -am "message" # Add and commit git commit --amend

Branching

git branch git branch git checkout git checkout -b git switch git switch -c

Merging

git merge git merge --no-ff git rebase

Remote

git fetch git pull git push git push -u origin ```

Branching Strategy (Git Flow)

``` main ─────●─────────────●─────────────●─────── │ │ │ release ─────┼─────●───────┼─────────────┼─────── │ │ │ │ develop ─────●─────┼───────●─────────────●─────── │ │ │ │ feature ─────●─────┘ │ │ │ │ hotfix ───────────────────●─────────────┘ ```

Branch Naming

```bash

Features

feature/add-agent-api feature/GA-123-user-auth

Bugfixes

bugfix/fix-agent-timeout bugfix/GA-456-memory-leak

Hotfixes

hotfix/critical-security-patch

Releases

release/v1.0.0 ```

Commit Message Convention

```bash

Format

():

Types

feat: New feature fix: Bug fix docs: Documentation style: Formatting (no code change) refactor: Code refactoring test: Adding tests chore: Maintenance

Examples

git commit -m "feat(agent): add Claude agent support" git commit -m "fix(api): resolve timeout in task processing" git commit -m "docs: update deployment instructions" ```

Common Workflows

Start Feature

```bash git checkout develop git pull origin develop git checkout -b feature/new-feature

... work ...

git add . git commit -m "feat: implement new feature" git push -u origin feature/new-feature

Create PR to develop

```

Sync Feature Branch

```bash git checkout develop git pull origin develop git checkout feature/my-feature git rebase develop

Resolve conflicts if any

git push --force-with-lease ```

Squash Commits

```bash git rebase -i HEAD~3 # Interactive rebase last 3 commits

Change 'pick' to 'squash' for commits to combine

```

Undo Changes

```bash

Undo last commit (keep changes)

git reset --soft HEAD~1

Undo last commit (discard changes)

git reset --hard HEAD~1

Undo staged changes

git restore --staged

Discard working directory changes

git restore

Revert a commit (creates new commit)

git revert ```

GitHub CLI

```bash

PR Management

gh pr create --title "Feature: Add agent API" --body "Description" gh pr list gh pr checkout gh pr merge gh pr review --approve

Issues

gh issue create --title "Bug: Agent timeout" --label bug gh issue list gh issue close

Repository

gh repo clone / gh repo view --web ```

.gitignore Patterns

```gitignore

Dependencies

node_modules/ venv/ pycache/

Build outputs

dist/ build/ *.egg-info/

Environment

.env .env.local *.local

IDE

.idea/ .vscode/ *.swp

OS

.DS_Store Thumbs.db

Logs

*.log logs/

Secrets (never commit!)

*.pem *.key credentials.json ```

Git Hooks

```bash

.git/hooks/pre-commit

#!/bin/sh npm run lint npm run test

.git/hooks/commit-msg

#!/bin/sh if ! grep -qE "^(feat|fix|docs|style|refactor|test|chore)((.+))?: .{1,50}" "$1"; then echo "Invalid commit message format" exit 1 fi ```