# GitFlow — Shared Reference

## Config Schema (v2.1.0)

The config lives at `.claude/gitflow/config.json` and is managed by `ss gitflow init`.

Key fields:
- `repository.name` — Project name
- `repository.remoteUrl` — Git remote URL
- `git.provider` — `github` or `azuredevops`
- `git.branches.main` / `.develop` — Main branch names
- `git.prefixes.feature` / `.release` / `.hotfix` — Branch prefixes
- `worktrees.mode` — `organized` (01-Main, 02-Develop), `simple`, or `disabled`
- `worktrees.structure.*` — Absolute paths to worktree directories
- `versioning.current` — Current SemVer version

## Conventions

- **Feature** branches from `develop`, merge back via squash
- **Release/Hotfix** branches from `main`, merge via merge commit (--no-ff), then merge-back to develop
- Version bumps: feature=none, release=minor, hotfix=patch
- Tags: `v{VERSION}` on main after release/hotfix merge
- Worktree paths: `features/{name}`, `releases/{version}`, `hotfixes/{name}`
- Only `01-Main` and `02-Develop` may use numbered prefixes
