speckit-git-validate

You can validate Git feature-branch naming by checking the active branch against predefined sequential or timestamp prefix patterns. The validation reports pattern conformance and whether a matching spec directory exists under specs/.

Supported Git branch naming patterns include sequential numeric prefixes like 001-feature-name or 042-fix-bug and timestamp prefixes like 20260319-143022-feature-name. These patterns determine feature work and locate corresponding spec directories.

To check for a corresponding spec directory, the validation process matches the active Git branch prefix against directories under specs/. This confirms whether the required spec folder exists for the current feature work.

Branch name validation can proceed without an active Git repository by using the SPECIFY_FEATURE environment variable as a fallback. The validation provides warnings instead of failing when Git is unavailable or not in a repo context.

If your Git branch name doesn't match feature-branch conventions, the validation reports the pattern mismatch. You should rename the branch using a sequential prefix like 001-feature-name or a timestamp prefix, and ensure a matching spec directory exists under specs/.

Git branch validation works with both sequential and timestamp naming schemes. It enforces pattern checks for sequential prefixes like 001-feature-name and timestamp prefixes like 20260319-143022-feature-name, reporting conformance and spec directory existence.