Engineering
qcc-git avatar

qcc-git

Git workflow and branch management tool for the qcc_plus project, enforcing standardized commit conventions and secure deployment processes.

Introduction

The qcc-git skill provides a structured framework for managing the Git lifecycle of the qcc_plus project. It is designed for developers, DevOps engineers, and contributors who need to maintain code quality while working within the multi-tenant proxy service architecture. By standardizing branching strategies and commit messages, this tool ensures that automated CI/CD pipelines function correctly and that version control remains clean across distributed environments.

  • Enforces a mandatory three-tier branch policy: test (daily development/auto-deployment), main (official release/tagging), and prod (production deployment).

  • Implements Conventional Commits requirements (feat, fix, refactor, etc.) to ensure automated changelog generation and versioning compatibility.

  • Provides a secure Git execution protocol that prevents accidental force pushes, unauthorized configuration changes, and ensures code review compliance.

  • Integrates with shell-based Git workflows, offering specific bash commands for seamless branch switching and deployment orchestration.

  • Includes quality assurance standards such as unit testing requirements, Go test race detection, and rigorous code review checklists for goroutine safety and error handling.

  • Users must confirm they are on the correct branch using git branch --show-current before starting any development tasks.

  • Commit messages must strictly follow the type: description format to avoid merge rejection.

  • Developers should use the provided HEREDOC templates for all commits to maintain consistency with the Claude Code interaction model.

  • The tool is designed to work in conjunction with the project's .githooks configuration for local validation.

  • Adhere to the provided safety constraints: never bypass hooks and always verify authorship before pushing changes.

Repository Stats

Stars
42
Forks
13
Open Issues
0
Language
Go
Default Branch
main
Sync Status
Idle
Last Synced
May 3, 2026, 04:47 PM
View on GitHub