speckit-git-feature

Git feature branch creation is automated by generating and switching to a new branch for a given specification. It enforces consistent naming conventions using sequential or timestamp-based numbering to maintain project organization.

You can set an explicit Git branch name by defining the GIT_BRANCH_NAME environment variable. When provided, this variable overrides the default sequential or timestamp-based auto-numbering logic for the feature branch.

Validating Git availability and repository context happens automatically before creating a feature branch. The process checks for an active Git repository to ensure branch creation and switching will succeed without context errors.

After creating a feature branch, the process exposes BRANCH_NAME and FEATURE_NUM variables. These outputs allow downstream tooling and automation scripts to reference the exact branch name and feature number for subsequent tasks.

Feature branch creation supports timestamp-based numbering as an alternative to sequential numbering. This mode generates branch names using current timestamps, useful for tracking exact creation times in version control workflows.

The best way to integrate feature branch creation into a spec-driven workflow is passing a specification to the process. It delegates spec creation to the core workflow while handling branch creation, switching, and numbering automatically.