Skip to content
Documentation
Command

/github-init

Initialize ClaudeForge CI/CD system

From plugin
claudeforge
4144 skills4 commands3 hooks

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/github-init

Context preview

What this command does when you run it.

Initialize ClaudeForge CI/CD system

Command definition

github-init.md
title: /github-init
description: Initialize ClaudeForge CI/CD system

GitHub CI/CD Initialization

You are helping the user initialize the ClaudeForge CI/CD system.

Workflow

1. **Check Current State**

  • Verify `.github/workflows/` directory exists
  • Check if bootstrap workflow has been run (look for labels/milestones)
  • Check if dev branch exists
  • Check branch protection status

2. **Run Bootstrap Workflow**

  • If not yet run, guide user to run bootstrap workflow:
  • Go to Actions → Bootstrap Repository → Run workflow
  • Enable all options (create labels, milestones, validate settings)
  • Explain what will be created (23 labels, 3 milestones)

3. **Create Dev Branch** (if not exists)

   git checkout -b dev
   git push -u origin dev

4. **Configure Branch Protection**

Guide user step-by-step:

**For main branch:**

  • Go to Settings → Branches → Add rule
  • Pattern: `main`
  • Enable:
  • Require PR before merging
  • Require status checks: `quality-gates`, `production-build`, `validate-release-pr`
  • Require linear history
  • Block force pushes
  • Restrict deletions

**For dev branch:**

  • Pattern: `dev`
  • Enable:
  • Require PR before merging
  • Require status checks: `quality-gates`, `validate-pr`
  • Require linear history
  • Block force pushes
  • Restrict deletions

5. **Set Default Branch**

  • Settings → General → Default branch → Change to `dev`
  • This ensures new PRs target dev by default

6. **Verification**

  • Show current branch protection rules
  • Verify workflows are present
  • Confirm setup is complete

7. **Next Steps**

  • Point to docs/GITHUB_WORKFLOWS.md for workflow reference
  • Point to docs/BRANCHING_STRATEGY.md for branch flow
  • Suggest creating first feature branch to test

Commands to provide

# Check current setup
gh repo view --json name,defaultBranchRef,hasIssuesEnabled

# List workflows
ls -la .github/workflows/

# Check labels
gh label list

# Check milestones
gh api repos/:owner/:repo/milestones

# Check branch protection
gh api repos/:owner/:repo/branches/main/protection 2>/dev/null || echo "Not protected"
gh api repos/:owner/:repo/branches/dev/protection 2>/dev/null || echo "Not protected"

Success Criteria

✅ Bootstrap workflow run successfully ✅ Dev branch created and pushed ✅ Branch protection configured for main and dev ✅ Default branch set to dev ✅ User understands next steps

Provide clear, step-by-step guidance with actual commands the user can copy-paste.

Read more
Ships withclaudeforge

Automated CLAUDE.md creation, enhancement, and maintenance for Claude Code projects ClaudeForge is a comprehensive toolkit that eliminates the tedious process of manually creating and maintaining CLAUDE.md files.

Get the whole plugin
Stats
414
Stars
52
Forks
Maintained
Maintenance
Python
Language
MIT
License
2mo ago
Last commit
9mo ago
Created

Repo: alirezarezvani/ClaudeForge