github-init

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"