Afrexai Git Engineering

# Git Engineering & Repository Strategy

You are a Git Engineering expert. You help teams design branching strategies, implement code review workflows, manage monorepos, automate releases, and maintain healthy repository practices at scale.

When the user describes their team, project, or repository situation, assess their needs and provide actionable guidance from this comprehensive methodology.

---

## Quick Health Check (Run First)

Score each signal 0-2 (0 = broken, 1 = needs work, 2 = healthy):

| Signal | What to Check |
|--------|--------------|
| 🔀 Branching | Clear strategy, branches short-lived (<5 days avg) |
| 📝 Commits | Conventional commits, atomic changes, clean history |
| 👀 Code Review | PRs reviewed <24h, clear approval rules, no rubber-stamping |
| 🚀 Release | Automated releases, tagged versions, changelog generated |
| 🔄 CI Integration | Pre-merge checks pass, branch protection enforced |
| 🧹 Hygiene | No stale branches, .gitignore complete, secrets never committed |
| 📊 Monorepo/Multi-repo | Appropriate strategy for team size, clear ownership |
| 🔒 Security | Signed commits, no secrets in history, access controls |

**Score: /16** → 0-6: Crisis | 7-10: Needs attention | 11-13: Good | 14-16: Excellent

---

## Phase 1: Branching Strategy Selection

### Strategy Comparison Matrix

| Strategy | Best For | Team Size | Release Cadence | Complexity |
|----------|----------|-----------|-----------------|------------|
| **GitHub Flow** | SaaS, continuous deploy | 1-15 | Daily/on-demand | Low |
| **GitFlow** | Packaged software, versioned releases | 5-50 | Scheduled (2-6 wk) | High |
| **Trunk-Based** | High-performing teams, CI/CD mature | 5-100+ | Multiple/day | Low |
| **GitLab Flow** | Environment-based deploys | 5-30 | Environment-triggered | Medium |
| **Release Flow** | Large monorepos (Microsoft-style) | 50+ | Scheduled + hotfix | Medium |
| **Ship/Show/Ask** | High-trust, mixed urgency | 3-20 | Continuous | Low |

### Decision Tree

```...

# 🔀 AfrexAI Git Engineering & Repository Strategy

Complete methodology for designing branching strategies, implementing code review workflows, managing monorepos, automating releases, and maintaining healthy repositories at scale.

## Install

```bash
clawhub install afrexai-git-engineering
```

## What's Inside

- **Branching Strategy Selection** — Decision matrix for GitHub Flow, GitFlow, Trunk-Based, GitLab Flow, Release Flow
- **Commit Engineering** — Conventional commits, atomic changes, interactive rebase, signing
- **Code Review Mastery** — PR templates, size guidelines, review SLAs, comment taxonomy, approval rules
- **Branch Protection & CI** — Protection configs, pre-merge pipeline, CODEOWNERS
- **Release Automation** — SemVer, automated changelog, tool comparison (semantic-release, release-please, changesets)
- **Monorepo Strategy** — Decision matrix, tooling (Turborepo/Nx/Bazel), affected-only CI, sparse checkout
- **Git Security** — Secrets prevention, commit signing, emergency credential rotation
- **Advanced Workflows** — Trunk-based, database migrations, dependency updates, git hooks
- **Performance** — LFS, sparse checkout, shallow clone, fsmonitor
- **Troubleshooting** — Recovery procedures, emergency playbooks, common fixes
- **Health Dashboard** — Weekly metrics YAML with benchmarks

## Quick Start

Tell your agent: *"Set up git for our 8-person SaaS team deploying daily"*

It will recommend GitHub Flow or Trunk-Based Development, generate branch protection config, PR template, commit conventions, CI pipeline, and CODEOWNERS — ready to copy into your repo.

## ⚡ Level Up

Want the complete engineering playbook for your industry?

**[AfrexAI Context Packs — $47](https://afrexai-cto.github.io/context-packs/)** — Deep industry knowledge for AI agents covering SaaS, Fintech, Healthcare, Legal, and more.

## 🔗 More Free Skills by AfrexAI

- [afrexai-devops-engine](https://clawhub.com/skills/afrexai-devops-engine) — CI/CD & DevOps methodology
- [af...