speckit-git-feature

To automate git feature branch creation, this tool reads a feature specification and branch_numbering configuration to generate a deterministic branch name. It creates and switches to the branch automatically, outputting BRANCH_NAME and FEATURE_NUM variables for downstream automation workflows.

Deterministic feature branch numbering is a standardized git workflow process that assigns sequential or timestamp-based prefixes to feature branches. This ensures consistent naming, reduces manual errors, and provides traceable FEATURE_NUM outputs for downstream automation tracking.

Yes, the generated git feature branch name can be overridden using the GIT_BRANCH_NAME environment variable. When configured, this variable takes priority over the standard sequential or timestamp numbering generated from the branch_numbering configuration.

The automated branch creation tool validates git availability and handles environments without an active git repository gracefully. If git is missing or the directory is not a repository, it skips branch creation while still outputting BRANCH_NAME and FEATURE_NUM for automation continuity.

Configuring sequential versus timestamp numbering for feature branches is managed through the branch_numbering configuration file. The tool reads this configuration to determine the prefix format, ensuring standardized naming across the software development workflow.

The best way to standardize feature branch naming is to use a specification-driven automation tool that applies deterministic sequential or timestamp prefixes. This enforces consistent naming, eliminates manual errors, and integrates with spec-kit workflows via the .specify/ directory.