tomevault-io 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 ```
Converted and distributed by TomeVault — claim your Tome and manage your conversions.