Skip to main content

speckit-git-validate

Validate current branch follows feature branch naming conventions

Source facts

Repository
elsa-workflows/elsa-core
Last source activity
October 8, 2026 at 13:33
Detected SKILL.md language
English
Stars
7,934
Forks
1,536

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
speckit-git-validate
description
Validate current branch follows feature branch naming conventions
compatibility
Requires spec-kit project structure with .specify/ directory
metadata
{"author":"github-spec-kit","source":"git:commands/speckit.git.validate.md"}
# 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 ``` ## Validation Rules Get the current branch name: ```bash git rev-parse --abbrev-ref HEAD ``` The branch name must match one of these patterns: 1. **Sequential**: `^[0-9]{3,}-` (e.g., `001-feature-name`, `042-fix-bug`, `1000-big-feature`) 2. **Timestamp**: `^[0-9]{8}-[0-9]{6}-` (e.g., `20260319-143022-feature-name`) ## Execution If on a feature branch (matches either pattern): - Output: `✓ On feature branch: <branch-name>` - Check if the corresponding spec directory exists under `core/docs/specs/`: - For sequential branches, look for `core/docs/specs/<prefix>-*` where prefix matches the numeric portion - For timestamp branches, look for `core/docs/specs/<prefix>-*` where prefix matches the `YYYYMMDD-HHMMSS` portion - 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 or 20260319-143022-feature-name` ## Graceful Degradation If Git is not installed or the directory is not a Git repository: - Check the `SPECIFY_FEATURE` environment variable as a fallback - If set, validate that value against the naming patterns - If not set, skip validation with a warning
View on GitHub