Skill

branch

Creates new git branch, initializes spec directory at YYYY/MM/branch-name/ with 000-backlog.md, commits it. Requires clean git state. Triggers on 'create branch' keywords.

Git

Bash

automation

developer-tools

npx claudepluginhub waterplanai/agentic-config --plugin ac-git

Tool Access

This skill is limited to using the following tools:

BashWrite

Preview

Create a new git branch and its corresponding spec directory.

SKILL.md

Similar Skills

create-branch

Parses input to create or reuse Git feature branches and changes/ directories in Git/non-Git workspaces, generates names from descriptions if unspecified, outputs BRANCH_NAME, FEATURE_DIR, SPEC_FILE.

omni

create-branch

Creates Git feature branch or worktree from base branch before writing artifacts. Infers name like feat/kebab-topic from context and confirms options with user.

1 file1 tool

vgv-wingspan

creating-branch

Creates Git feature branches with short auto-incremented names and type prefixes (feat/fix/refactor/chore/docs). Generates from manual descriptions, uncommitted changes, or Arkhe SDLC specs.

3 files

git

Stats

Parent Repo Stars28

Parent Repo Forks6

Last CommitMar 6, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Create Branch with Spec Directory

Create a new git branch and its corresponding spec directory.

Pre-Flight Checks

Verify clean git state:

If dirty: STOP and list uncommitted changes

Validate branch name:

Must be provided as argument
If empty: STOP with "Branch name required"

Execution

Create and checkout branch:

git checkout -b $ARGUMENTS

Resolve and create spec directory:

# Source spec resolver (plugin-aware)
source "${CLAUDE_PLUGIN_ROOT}/scripts/spec-resolver.sh"

# Resolve spec path (handles external vs local)
RELATIVE_PATH="$(date +%Y)/$(date +%m)/$ARGUMENTS/000-backlog.md"
SPEC_FILE=$(resolve_spec_path "$RELATIVE_PATH")
SPEC_DIR="${SPEC_FILE%/*}"  # Pure bash dirname equivalent

# Create backlog file
touch "$SPEC_FILE"

Path: Auto-resolved based on .env configuration
- External: .specs/specs/<YYYY>/<MM>/<branch-name>/
- Local: specs/<YYYY>/<MM>/<branch-name>/
Creates 000-backlog.md (empty file)

Commit spec directory:

# Extract NNN and title for commit_spec_changes
# For backlog, use "000" and "backlog"
commit_spec_changes "$SPEC_FILE" "CREATE" "000" "backlog"

CRITICAL: Must commit BEFORE creating worktree, otherwise spec files are lost

Confirm:

- Branch: $ARGUMENTS
- Spec dir: <resolved-path>
- Backlog: 000-backlog.md (committed)

Conditional Documentation

When configuring external specs repository or modifying spec path resolution, read:

${CLAUDE_PLUGIN_ROOT}/scripts/spec-resolver.sh

${CLAUDE_PLUGIN_ROOT}/scripts/external-specs.sh

${CLAUDE_PLUGIN_ROOT}/scripts/lib/config-loader.sh

Create Branch with Spec Directory

Create a new git branch and its corresponding spec directory.

Pre-Flight Checks

Verify clean git state:
- If dirty: STOP and list uncommitted changes
Validate branch name:
- Must be provided as argument
- If empty: STOP with "Branch name required"

Execution

Create and checkout branch:
```
git checkout -b $ARGUMENTS
```

Resolve and create spec directory:

# Source spec resolver (plugin-aware)
source "${CLAUDE_PLUGIN_ROOT}/scripts/spec-resolver.sh"

# Resolve spec path (handles external vs local)
RELATIVE_PATH="$(date +%Y)/$(date +%m)/$ARGUMENTS/000-backlog.md"
SPEC_FILE=$(resolve_spec_path "$RELATIVE_PATH")
SPEC_DIR="${SPEC_FILE%/*}"  # Pure bash dirname equivalent

# Create backlog file
touch "$SPEC_FILE"

Path: Auto-resolved based on .env configuration
- External: .specs/specs/<YYYY>/<MM>/<branch-name>/
- Local: specs/<YYYY>/<MM>/<branch-name>/
Creates 000-backlog.md (empty file)

Commit spec directory:

# Extract NNN and title for commit_spec_changes
# For backlog, use "000" and "backlog"
commit_spec_changes "$SPEC_FILE" "CREATE" "000" "backlog"

CRITICAL: Must commit BEFORE creating worktree, otherwise spec files are lost

Confirm:

- Branch: $ARGUMENTS
- Spec dir: <resolved-path>
- Backlog: 000-backlog.md (committed)

Conditional Documentation

When configuring external specs repository or modifying spec path resolution, read:

${CLAUDE_PLUGIN_ROOT}/scripts/spec-resolver.sh
${CLAUDE_PLUGIN_ROOT}/scripts/external-specs.sh
${CLAUDE_PLUGIN_ROOT}/scripts/lib/config-loader.sh