git-flow-next

# Git-Flow-Next Skill

Git-flow-next is a modern, Go-based implementation of the git-flow branching model with support for preset workflows (Classic GitFlow, GitHub Flow, GitLab Flow) and fully customizable branch configurations.

## Quick Start

**Prerequisites:** git-flow-next must be installed. See `references/installation.md` for setup instructions.

**Initialize your repository:**
```bash
# Interactive (choose preset: classic, github, gitlab)
git-flow init

# With preset (no prompts)
git-flow init --preset=classic --defaults

# Custom configuration
git-flow init --custom
```

**Common branch operations:**
```bash
# Start and finish a feature
git-flow feature start my-feature
git-flow feature finish my-feature

# Start and finish a release
git-flow release start 1.2.0
git-flow release finish 1.2.0

# Emergency production fix
git-flow hotfix start 1.2.1
git-flow hotfix finish 1.2.1
```

## Branch Management

### Feature Branches

**Start a feature:**
```bash
git-flow feature start authentication
```
Creates `feature/authentication` from `develop`.

**Finish a feature:**
```bash
git-flow feature finish authentication
```
- Merges into `develop`
- Deletes feature branch
- Returns to `develop`

**List active features:**
```bash
git-flow feature list
```

**Delete without merging:**
```bash
git-flow feature delete authentication
```

### Release Branches

**Start a release:**
```bash
git-flow release start 1.2.0
```
Creates `release/1.2.0` from `develop`.

**Finish a release:**
```bash
git-flow release finish 1.2.0
```
- Merges into `main`
- Tags `main` with `v1.2.0`
- Merges back into `develop`
- Deletes release branch

**List pending releases:**
```bash
git-flow release list
```

### Hotfix Branches

**Start a hotfix:**
```bash
git-flow hotfix start 1.2.1
```
Creates `hotfix/1.2.1` from `main` (critical: from production, not develop).

**Finish a hotfix:**
```bash
git-flow hotfix finish 1.2.1
```
- Merges into `main`
- Tags `main` with `v1.2.1`
- Merges back into `