/flow-start

Start a new feature, bugfix, or hotfix branch following git-flow conventions.

Steps

1. Determine the flow type from the argument:

• `feature/<name>` for new features (branches from `develop` or `main`).
• `bugfix/<name>` for non-critical fixes (branches from `develop`).
• `hotfix/<name>` for critical production fixes (branches from `main`).

2. Verify the working tree is clean: `git status --porcelain`. 3. Fetch latest from remote: `git fetch origin`. 4. Create the branch from the appropriate base:

• `git checkout -b <type>/<name> origin/<base>`.

5. Set up branch tracking: `git push -u origin <type>/<name>`. 6. If a GitHub issue is referenced, link it:

• Name the branch `<type>/<issue-number>-<description>`.

7. Display the branch info and next steps.

Format

Flow started:
  Type: <feature|bugfix|hotfix>
  Branch: <branch-name>
  Base: <base-branch>
  Tracking: origin/<branch-name>

Next steps:
  1. Make your changes
  2. Commit with conventional messages
  3. Run: /git-flow:flow-release to merge

Rules

• Always branch from a clean, up-to-date base branch.
• Use lowercase kebab-case for branch names.
• Include issue number in branch name when applicable.
• Hotfix branches must always branch from the production branch.
• Verify no branch with the same name already exists.