/github-init

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.