gitplus

NeuBlink/gitplus

3.2

If you are the rightful owner of gitplus and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Gitplus is a Model Context Protocol (MCP) server that integrates AI-powered git automation into Claude Code, enhancing git workflows with intelligent features.

Tools
7
Resources
0
Prompts
0

GitPlus GitHub Configuration

This directory contains GitHub-specific configuration files, workflows, and scripts for the GitPlus repository.

šŸ“ Directory Structure

.github/
ā”œā”€ā”€ docs/                          # Documentation for workflows and processes
ā”‚   ā”œā”€ā”€ branch-protection-setup.md # Branch protection configuration guide
ā”‚   ā””ā”€ā”€ workflow-configuration.md  # Comprehensive workflow configuration guide
ā”œā”€ā”€ ISSUE_TEMPLATE/                # GitHub issue templates
ā”‚   ā”œā”€ā”€ bug_report.md              # Bug report template
ā”‚   ā””ā”€ā”€ feature_request.md         # Feature request template
ā”œā”€ā”€ scripts/                       # Reusable workflow scripts
ā”‚   ā”œā”€ā”€ generate-merge-prompt.sh   # Creates AI merge decision prompts
ā”‚   ā””ā”€ā”€ generate-todo-list.sh      # Generates TODO lists for rejected PRs
ā””ā”€ā”€ workflows/                     # GitHub Actions workflows
    ā”œā”€ā”€ ci.yml                     # Continuous Integration pipeline
    ā”œā”€ā”€ claude-code-review.yml     # Automated Claude code reviews
    ā”œā”€ā”€ claude.yml                 # Interactive Claude assistance
    ā”œā”€ā”€ dependencies.yml           # Dependency update automation
    ā”œā”€ā”€ merge-decision.yml         # AI-powered merge decisions
    ā”œā”€ā”€ pr-checks.yml              # Pull request validation
    ā”œā”€ā”€ publish.yml                # NPM package publishing
    ā”œā”€ā”€ release-please-post.yml    # Post-release automation
    ā”œā”€ā”€ release-please.yml         # Automated release management
    ā””ā”€ā”€ release.yml                # Release publishing workflow

šŸš€ Key Workflows

Core Automation

  • claude-code-review.yml: Automatic comprehensive code reviews using Claude AI
  • merge-decision.yml: AI-powered merge decisions with TODO list generation
  • ci.yml: Multi-platform testing and validation
  • pr-checks.yml: Pull request validation and compatibility testing

Release Management

  • release-please.yml: Automated version bumps and changelog generation
  • release-please-post.yml: Post-release package.json synchronization
  • publish.yml: NPM package publishing with propagation checking
  • release.yml: GitHub release creation

Maintenance

  • dependencies.yml: Automated dependency updates
  • claude.yml: Interactive Claude assistance on issues and PRs

šŸ”§ Scripts

generate-merge-prompt.sh

Creates structured prompts for AI merge decisions with proper context injection.

Usage:

.github/scripts/generate-merge-prompt.sh

generate-todo-list.sh

Generates actionable TODO lists for rejected PRs based on rejection reasons and critical issues.

Usage:

.github/scripts/generate-todo-list.sh "$REASON" "$CRITICAL_ISSUES"

šŸ“š Documentation

workflow-configuration.md

Comprehensive guide for configuring and customizing GitPlus workflows including:

  • Adaptive polling parameters
  • Performance optimization
  • Security configuration
  • Troubleshooting guide

branch-protection-setup.md

Instructions for setting up repository branch protection rules that work with GitPlus automation.

šŸ”’ Security Features

All workflows implement security best practices:

  • Minimal permissions: Each workflow uses least-privilege access
  • Input validation: All user inputs are validated with regex patterns
  • Safe contexts: No direct execution of user-controlled content
  • Token scoping: Proper GitHub token usage with explicit permissions

šŸŽÆ Workflow Triggers

  • Pull Requests: claude-code-review.yml, merge-decision.yml, ci.yml, pr-checks.yml
  • Releases: release-please.yml, publish.yml, release.yml
  • Schedules: dependencies.yml (weekly)
  • Manual: merge-decision.yml (workflow_dispatch for debugging)
  • Issues/Comments: claude.yml (interactive assistance)

šŸšØ Required Secrets

Configure these secrets in your repository settings:

secrets:
  CLAUDE_CODE_OAUTH_TOKEN    # Claude AI integration token
  NPM_TOKEN                  # NPM publishing token (for releases)
  # GITHUB_TOKEN is automatically provided

šŸ“Š Monitoring

Key metrics to monitor:

  • Claude review success rate
  • Auto-merge success rate
  • Workflow execution times
  • False rejection rates

See docs/workflow-configuration.md for detailed monitoring setup.

šŸ› ļø Development

When modifying workflows:

  1. Test locally: Use the test suite in tests/workflows/
  2. Validate syntax: Ensure YAML is properly formatted
  3. Security review: Follow security guidelines in documentation
  4. Documentation: Update this README and workflow-configuration.md

šŸ¤ Contributing

For workflow improvements:

  1. Test changes thoroughly with dry-run capabilities
  2. Maintain backward compatibility
  3. Update documentation
  4. Consider security implications
  5. Use the GitPlus ship command for consistent commits

This configuration enables fully automated, AI-powered development workflows while maintaining security and reliability.