create-branch

Create Branch Command – Interactive Branch Creation

When /create-branch is invoked, immediately execute the following steps to interactively create a new feature branch with proper naming conventions.

---

Step 1: Load Project Context & Follow All Rules

1. Assume the project root as the working directory
2. Load and strictly follow ALL Cursor rules from .cursor/rules/*.mdc:
   • security.mdc - Security requirements
   • technical-stack.mdc - React Native/SQLite patterns
   • documentation.mdc - Documentation update requirements
   • version-management.mdc - Git commit/push workflow
   • general-principles.mdc - Project philosophy
3. Check current git status and branch
4. Read PROGRESS.md to understand current project state

---

Step 2: Check Current State

1. Check current branch:

   git branch --show-current
   

2. Check for uncommitted changes:

   git status
   

3. If uncommitted changes exist:

   • Stop and ask user to commit or stash first
   • Never create branch with uncommitted changes
   • Provide options: commit now, stash, or cancel

4. If on main/master:

   • Proceed (this is expected for creating new branches)
   • Will switch to main/master before creating branch

---

Step 3: Ask for Branch Name

1. Prompt user for branch name:

   • Ask: "What would you like to name the new branch?"
   • Provide examples of good branch names
   • Explain naming conventions

2. Wait for user input:

   • User will provide the branch name
   • Validate the name before proceeding

---

Step 4: Validate and Normalize Branch Name

1. Validate branch name:

   • Must not be empty
   • Must not contain spaces (replace with hyphens)
   • Must not start with special characters
   • Must not be main, master, or protected branch names
   • Should be lowercase (convert if needed)

2. Apply naming conventions:

   • If name doesn't start with feature/, fix/, refactor/, or docs/:
     • Ask user which type: feature, fix, refactor, or docs
     • Prepend appropriate prefix: feature/, fix/, refactor/, or docs/
   • If name already has prefix, use it as-is
   • Convert to lowercase
   • Replace spaces and underscores with hyphens
   • Remove special characters (keep only alphanumeric and hyphens)