Validate Feature Branch

Validate that the current Git branch follows the expected feature branch naming conventions.

Prerequisites

Check if Git is available by running git rev-parse --is-inside-work-tree 2>/dev/null

If Git is not available, output a warning and skip validation:

[specify] Warning: Git repository not detected; skipped branch validation

Get the current branch name:

bash

git rev-parse --abbrev-ref HEAD

The branch name's final path segment must start with one of these feature markers:

Sequential: [0-9]{3,}- (e.g., 001-feature-name, 042-fix-bug, 1000-big-feature, jdoe/web/008-guided-tour)
Timestamp: [0-9]{8}-[0-9]{6}- (e.g., 20260319-143022-feature-name, jdoe/web/20260319-143022-feature-name)

If on a feature branch (matches either pattern):

Output: ✓ On feature branch: <branch-name>
Check if the corresponding spec directory exists under specs/:
- For sequential branches, look for specs/<prefix>-* where prefix matches the numeric portion, regardless of branch namespace prefixes
- For timestamp branches, look for specs/<prefix>-* where prefix matches the YYYYMMDD-HHMMSS portion, regardless of branch namespace prefixes
If spec directory exists: ✓ Spec directory found: <path>
If spec directory missing: ⚠ No spec directory found for prefix <prefix>

If NOT on a feature branch:

Output: ✗ Not on a feature branch. Current branch: <branch-name>
Output: Feature branches should be named like: 001-feature-name, 20260319-143022-feature-name, or <namespace>/001-feature-name

If Git is not installed or the directory is not a Git repository: