cicd-workflow

A Claude Code plugin that guides you through an end-to-end CI/CD workflow — from creating a branch to deploying and rolling back in production — using a single /cicd skill that routes to the right step-by-step guide.

What it covers

Phase	Tasks
SCM	Create branch, commit changes
CI	Open PR, review and fix PR, rerun CI
CD	Deploy, check deployment health, rollback

Prerequisites

• Claude Code installed
• git and gh (GitHub CLI) installed and authenticated
• For deployments (as applicable): kubectl, docker-compose, aws, gcloud, or az

Installation

1. Clone the repo

git clone https://github.com/balodesecurity/cicd-workflow.git ~/cicd-workflow

2. Set up a local marketplace (if you don't have one)

mkdir -p ~/local-marketplace/.claude-plugin
mkdir -p ~/local-marketplace/plugins

Create ~/local-marketplace/.claude-plugin/marketplace.json:

{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "local",
  "description": "Local plugins",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "cicd-workflow",
      "description": "End-to-end CI/CD workflow plugin",
      "source": "./plugins/cicd-workflow",
      "category": "devops"
    }
  ]
}

3. Symlink and register

ln -s ~/cicd-workflow ~/local-marketplace/plugins/cicd-workflow
claude plugins marketplace add ~/local-marketplace

4. Install the plugin

claude plugins install cicd-workflow@local

5. Start a new Claude Code session

The /cicd skill will be available in your next session.

Usage

Just describe what you want to do — Claude will read the right guide and follow it:

/cicd  create a branch for the login feature
/cicd  commit my changes
/cicd  open a PR
/cicd  rerun CI
/cicd  deploy to staging
/cicd  is the deployment healthy?
/cicd  rollback production

Configuration

For deploy, deploy-status, and rollback, create a .cicd-config file in your repo root (or ~/.cicd-config for global defaults):

# Deployment commands per environment
DEPLOY_STAGING_CMD="kubectl apply -f k8s/staging/"
DEPLOY_PROD_CMD="kubectl apply -f k8s/prod/"

# SSH deployment
DEPLOY_HOST=myserver.example.com
DEPLOY_USER=deploy
DEPLOY_PATH=/srv/myapp

# Rollback tags (docker-compose)
ROLLBACK_TAG_STAGING=previous
ROLLBACK_TAG_PROD=stable

# Image registry (Kubernetes)
IMAGE_REPO=gcr.io/myproject/myapp

Structure

skills/
├── SKILL.md              — router: maps tasks to guides
├── scm/
│   ├── branch.md
│   └── commit.md
├── ci/
│   ├── create-pr.md
│   ├── rerun-ci.md
│   └── review-and-fix-pr.md
├── cd/
│   ├── deploy.md
│   ├── deploy-status.md
│   └── rollback.md
└── templates/
    └── pr-template.md

License

MIT — see LICENSE