Git

Commands for streamlined Git operations including commits and pull request creation with conventional commit messages.

Plugin Target

  • Maintain consistent commit history - Every commit follows conventional commit format

  • Reduce PR creation friction - Automated formatting, templates, and linking

  • Improve issue-to-code workflow - Clear technical specs from issue descriptions

  • Ensure team consistency - Standardized Git operations across the team

Overview

The Git plugin provides commands that automate and standardize Git workflows, ensuring consistent commit messages, proper PR formatting, and efficient issue management. It integrates GitHub best practices and conventional commits with emoji.

Most commands require GitHub CLI (gh) for full functionality including creating PRs, loading issues, and setting labels/reviewers.

Quick Start

# Install the plugin
/plugin install git@NeoLabHQ/context-engineering-kit

# Create a well-formatted commit
> /git:commit

# Create a pull request
> /git:create-pr

Analyze Open GitHub issues

# Load all open issues
> /git:load-issues

# Analyze a GitHub issue
> /git:analyze-issue 123

Usage Examples

Commands Overview

/git:commit - Conventional Commits

Create well-formatted commits with conventional commit messages and emoji.

  • Purpose - Standardize commit messages across the team

  • Output - Git commit with conventional format

/git:commit [flags]

Arguments

Optional flags like --no-verify to skip pre-commit checks.

How It Works

  1. Change Analysis: Reviews staged changes to understand what was modified

  2. Type Detection: Determines commit type (feat, fix, refactor, etc.)

  3. Message Generation: Creates descriptive commit message following conventions

  4. Emoji Selection: Adds appropriate emoji for the commit type

  5. Commit Creation: Executes git commit with formatted message

Commit Types with Emoji

Emoji
Type
Description

✨

feat

New feature

🐛

fix

Bug fix

📝

docs

Documentation changes

💄

style

Code style changes (formatting)

♻️

refactor

Code refactoring

⚡

perf

Performance improvements

✅

test

Adding or updating tests

🔧

chore

Maintenance tasks

🔨

build

Build system changes

👷

ci

CI/CD changes

Usage Examples

# Basic commit after making changes
> git add .
> /git:commit

# Skip pre-commit hooks
> /git:commit --no-verify

# After code review
> /code-review:review-local-changes
> /git:commit

Best Practices

  • Keep commits focused - One logical change per commit

  • Reference issues - Include issue numbers when applicable

  • Review before commit - Use code review commands first

/git:create-pr - Pull Request Creation

Create pull requests using GitHub CLI with proper templates and formatting.

  • Purpose - Streamline PR creation with consistent formatting

  • Output - GitHub pull request with template

/git:create-pr

Arguments

None required - interactive guide for PR creation.

How It Works

  1. Branch Detection: Identifies current branch and target base branch

  2. Template Search: Looks for PR templates in .github/ directory

  3. Change Summary: Analyzes commits to generate description

  4. PR Creation: Uses gh pr create with formatted content

  5. Issue Linking: Automatically links related issues

Usage Examples

# Create PR for current branch
> /git:create-pr

# After completing feature
> /git:commit
> /git:create-pr

# Full workflow
> /git:analyze-issue 123
> claude "implement feature"
> /git:commit
> /git:create-pr

Best Practices

  • Push branch first - Ensure branch is pushed to remote

  • Use descriptive titles - Clear summary of changes

  • Link issues - Reference related issues in description

  • Request reviewers - Add appropriate team members

/git:analyze-issue - Issue Analysis

Analyze a GitHub issue and create a detailed technical specification.

  • Purpose - Transform issues into actionable development tasks

  • Output - Technical specification with requirements

/git:analyze-issue <issue-number>

Arguments

Issue number (e.g., 42) - required.

How It Works

  1. Issue Fetching: Retrieves issue details from GitHub

  2. Requirements Extraction: Identifies user stories and acceptance criteria

  3. Technical Analysis: Determines APIs, data models, and dependencies

  4. Task Breakdown: Creates actionable subtasks

  5. Complexity Assessment: Estimates implementation effort

Usage Examples

# Analyze issue before starting work
> /git:analyze-issue 123

# Use with SDD workflow
> /git:analyze-issue 123
> /sdd:01-specify

# Plan sprint work
> /git:load-issues
> /git:analyze-issue 45
> /git:analyze-issue 67

Best Practices

  • Analyze before coding - Understand requirements first

  • Check issue completeness - Request clarification if needed

  • Note dependencies - Identify related issues or PRs

  • Use for planning - Helps estimate and prioritize work

/git:load-issues - Load Open Issues

Load all open issues from GitHub and save them as markdown files.

  • Purpose - Bulk import issues for planning and analysis

  • Output - Markdown files for each open issue

/git:load-issues

Arguments

None required - loads all open issues automatically.

How It Works

  1. Issue Retrieval: Fetches all open issues from repository

  2. Content Extraction: Parses issue title, body, labels, and metadata

  3. File Generation: Creates markdown file for each issue

  4. Organization: Structures files in designated directory

Usage Examples

# Load all issues for sprint planning
> /git:load-issues

# Then analyze specific issues
> /git:analyze-issue 123

Best Practices

  • Use for sprint planning - Get overview of all open work

  • Combine with analysis - Analyze high-priority issues in detail

  • Regular updates - Reload periodically to stay current

/git:attach-review-to-pr - PR Review Comments

Add line-specific review comments to pull requests using GitHub CLI API.

  • Purpose - Attach detailed code review feedback to PRs

  • Output - Review comments on specific lines

/git:attach-review-to-pr [pr-number]

Arguments

PR number or URL (optional - can work with current branch).

Usage Examples

# Add review comments to PR
> /git:attach-review-to-pr 456

# After code review
> /code-review:review-pr 456
> /git:attach-review-to-pr 456

Conventional Commit Format

The plugin follows the conventional commits specification:

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

Example Commit Messages

Feature Commit

✨ feat(auth): add OAuth2 authentication

Implement OAuth2 with Google and GitHub providers
- Add OAuthController for callback handling
- Implement token exchange and validation
- Add user profile synchronization

Closes #123

Bug Fix Commit

🐛 fix(cart): prevent duplicate items in shopping cart

Fix race condition when adding items concurrently
- Add distributed lock for cart operations
- Implement idempotency key validation

Fixes #456

Refactoring Commit

♻️ refactor(order): extract order processing logic

Improve code organization and testability
- Extract OrderProcessor from OrderController
- Implement strategy pattern for order types

Related to #789
PreviousUsage ExamplesNextKaizen

Last updated