go review deploy skills — Efficient code review and…

Pitch

Description

Comments

About this project

The go-review-deploy-skills project offers essential tools for Go backend developers. With capabilities to review code branches and plan production deployments, it enhances code quality and deployment safety. These advisory skills streamline workflows without altering code, ensuring significant support during the merging and deployment processes.

The go-review-deploy-skills project offers two specialized Claude Code skills tailored for Go backend repositories, facilitating a structured approach to code reviews and production deployments.

Overview

This project includes:

go-code-review: Utilized to review changes in a branch and generate severity-ranked findings based on differences from the target branch (default: main).

Command Usage:
```
/go-code-review [target-branch]
```
It outputs a review report detailing any issues identified since the branch's last merge, including a validation plan to ensure code quality.
prod-deployment-planner: Assists in creating a deployment checklist along with a sequential execution plan based on the candidate reference and environment.

Command Usage:
```
/prod-deployment-planner candidate=<ref> env=<name> deployed=<ref>
```
This tool ensures a comprehensive review of the deployment requirements, enhancing the safety and reliability of production releases.

Key Features

Advisory Nature: Both skills operate in a read-only mode, ensuring that they do not alter the repository's code or Git state.
Flexible Approval Process: Integrated approval gates allow for human oversight before final deployment, supporting decisions based on the findings from both tools.
Seamless Integration: Simple installation and symlink creation enable these skills to function across multiple repositories within the Claude Code environment.

Workflow

The workflow consists of two main steps:

Review a Feature Branch: Execute the /go-code-review command to analyze changes and generate a report that outlines potential issues and a validation plan.
Plan the Deployment: Use /prod-deployment-planner to finalize the release plan, confirming all necessary criteria are met before proceeding with deployment.

Approval Gates

Each step in the workflow includes defined gates to ensure that only validated changes proceed to production, mitigating risks associated with software releases.

Validation Gates: Multiple gates (like validation checks and re-approval requirements) are triggered based on the current state of the code change and the previous reviews.
Human Oversight: Critical decisions, including the final go/no-go for deployment, are reserved for human judgment, maintaining control over production releases.

This project demands only basic tools such as Git, awk, and sed, enabling smooth compatibility with macOS systems. By leveraging these two skills, developers can significantly enhance their code review processes and streamline production deployments for Go applications.