Github Workflow

GitHub Workflow

Automate the full GitHub development lifecycle: branches, commits, pushes, PRs, issues, and code review.

Quick Start

1. User requests a git action (commit, PR, branch, push, issue)
2. Check repo state: git status, git branch, git log --oneline -5
3. Execute the appropriate workflow below
4. Confirm result to user

Workflows

1. Branching

# Create feature branch from main
git checkout main && git pull origin main
git checkout -b /
# Types: feature/, bugfix/, docs/, refactor/, test/, chore/

• Always branch from up-to-date main
• Use conventional naming: feature/add-jwt-testing, bugfix/fix-port-detection

2. Committing

# Stage specific files (never git add -A blindly)
git add  
# Commit with conventional format
git commit -m "type(scope): description"

• Types: feat, fix, docs, refactor, test, chore
• Message focuses on why, not what
• Never commit .env, credentials, or secrets
• See [reference/commit-conventions.md](reference/commit-conventions.md)

3. Pushing

# First push (set upstream)
git push -u origin 
# Subsequent pushes
git push

• Never force-push to main/master without explicit user approval
• If push is rejected, git pull --rebase first

4. Pull Requests

# Create PR linking to issue
gh pr create --title "Short title 
EOF
)"

• Title

gh pr diff gh pr checks

Comment or approve

gh pr review --approve gh pr review --comment --body "feedback"

## Reference

- [commit-conventions.md](reference/commit-conventions.md) — Commit message format and examples
- [pr-workflow.md](reference/pr-workflow.md) — PR creation, review, and merge workflow
- [branch-strategy.md](reference/branch-strategy.md) — Branching model and naming conventions

## Critical Rules

- **NEVER** force-push to main/master without explicit user approval
- **NEVER** commit secrets, `.env` files, or credentials
- **NEVER** use `git add -A` without reviewing what's staged
- **NEVER** skip pre-commit hooks (`--no-verify`) unless user explicitly asks
- **NEVER** amend published commits — create new commits instead
- **ALWAYS** use conventional commit format: `type(scope): description`
- **ALWAYS** link PRs to issues
- **ALWAYS** check `git status` before committing
- **ALWAYS** pull before pushing to avoid conflicts
- **ALWAYS** create branches from up-to-date main

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [transilienceai](https://github.com/transilienceai)
- **Source:** [transilienceai/communitytools](https://github.com/transilienceai/communitytools)
- **License:** MIT
- **Homepage:** https://www.transilience.ai/

Install and usage instructions live in the source repository linked above.