feature-branch

Feature Branch Command – Branch Creation & Management Workflow

When /feature-branch <branch-name> or /feature-branch is invoked, immediately execute the following steps.

---

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
3. Check current git status and branch
4. Read PROGRESS.md to understand current project state

---

Step 2: Determine Branch Name

1. If branch name provided: Use <branch-name> from command
2. If no branch name provided:
   • Infer from current work context
   • Use format: feature/<description> or fix/<description>
   • Ask user for branch name if unclear
3. Validate branch name:
   • Use lowercase with hyphens (e.g., feature/search-reset-button)
   • Avoid special characters or spaces
   • Keep it descriptive but concise

---

Step 3: Check Current State

1. Check current branch:

   git branch --show-current
   

2. Check for uncommitted changes:

   git status
   

3. If uncommitted changes exist:

   • Commit them first (following version-management.mdc rules)
   • Or stash them if user prefers
   • Never create branch with uncommitted changes unless explicitly requested

4. If on main/master:

   • Warn user (but proceed if confirmed)
   • Always create feature branch from main/master

---

Step 4: Create Feature Branch

1. Ensure you're on the base branch (usually main or master):

   git checkout main  # or master
   git pull origin main  # or master
   

2. Create and switch to new branch:

   git checkout -b <branch-name>
   

3. Push branch to remote (set upstream):

   git push -u origin <branch-name>