speckit-git-validate

Feature branch naming validation checks the current Git branch against predefined patterns like sequential prefixes (001-feature) or timestamped prefixes (20260319-143022-feature) to ensure traceability and alignment with project specs.

Standard Git branch naming patterns for features include sequential prefixes (e.g., 001-feature) and timestamped prefixes (e.g., 20260319-143022-feature). These patterns ensure branch names reflect development intent and timing for better traceability.

Spec directory validation checks for a corresponding specs/ directory matching the identified feature prefix extracted from the Git branch name. This enables end-to-end validation when specs are present in the repository.

Branch naming validation works without Git by handling cases where Git is unavailable or the directory is not a repository. It emits informative messages and suggests optional fallbacks or environment variables as needed.

The best way to link Git branch names to spec directories is to validate the branch name's feature prefix and verify a matching specs/ directory exists. This ensures alignment between the branch intent and the defined specifications.