specify

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Outline

The text the user typed after /speckit.specify in the triggering message is the feature description. Assume you always have it available in this conversation even if {ARGS} appears literally below. Do not ask the user to repeat it unless they provided an empty command.

Given that feature description, do this:

1. Create New Feature Structure (replaces script execution):

   a. Find Repository Root and Initialize Features Directory:

   REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
   
   # Source features location helper
   SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
   PLUGIN_DIR="$(dirname "$SCRIPT_DIR")"
   source "$PLUGIN_DIR/lib/features-location.sh"
   
   # Initialize features directory (handles migration if needed)
   ensure_features_dir "$REPO_ROOT"
   

   b. Determine Next Feature Number:

   # Get next feature number using helper
   FEATURE_NUM=$(get_next_feature_number "$REPO_ROOT")
   

   c. Create Feature Slug from Description:

   # Convert description to kebab-case
   # Example: "User Authentication System" → "user-authentication-system"
   SLUG=$(echo "$ARGUMENTS" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//' | sed 's/-$//')
   

   d. Capture Parent Branch and Create Feature Branch (if git available):

   BRANCH_NAME="${FEATURE_NUM}-${SLUG}"
   
   if git rev-parse --git-dir >/dev/null 2>&1; then
     # Check if already on a feature branch (e.g., created by /ss:build)
     CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
     ALREADY_ON_FEATURE=$(echo "$CURRENT_BRANCH" | grep -E '^[0-9]{3}-')
   
     if [ -n "$ALREADY_ON_FEATURE" ]; then
       # Already on a feature branch - reuse it
       BRANCH_NAME="$CURRENT_BRANCH"
       FEATURE_NUM=$(echo "$CURRENT_BRANCH" | grep -oE '^[0-9]{3}')
       # Read parent from build state if available
       PARENT_BRANCH=""
       if [ -f "${REPO_ROOT}/.specswarm/build-loop.state" ] && command -v jq &>/dev/null; then
         PARENT_BRANCH=$(jq -r '.parent_branch // empty' "${REPO_ROOT}/.specswarm/build-loop.state" 2>/dev/null)
       fi
       if [ -z "$PARENT_BRANCH" ]; then
         PARENT_BRANCH="main"
       fi
       echo "Using existing feature branch: $BRANCH_NAME (parent: $PARENT_BRANCH)"
     else
       # Standalone mode: create new feature branch with confirmation
       PARENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
   
       echo ""
       echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
       echo "Branch Setup"
       echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
       echo "  Parent branch: $PARENT_BRANCH (current branch)"
       echo "  Feature branch: $BRANCH_NAME (will be created)"
       echo ""
       echo "ℹ️  The feature branch will be created from $PARENT_BRANCH."
       echo "   When complete, it will merge back to $PARENT_BRANCH."
       echo ""
       read -p "Is this correct? (y/n): " branch_confirm
   
       if [ "$branch_confirm" != "y" ]; then
         echo ""
         echo "❌ Branch setup cancelled"
         echo ""
         echo "Please checkout the correct parent branch first, then run:"
         echo "  /ss:specify \"$FEATURE_DESCRIPTION\""
         exit 0
       fi
       echo ""
   
       # Create and switch to new feature branch
       git checkout -b "$BRANCH_NAME"
     fi
   else
     # Non-git: use environment variable
     export SPECIFY_FEATURE="$BRANCH_NAME"
     PARENT_BRANCH="unknown"
   fi