Determine Feature Slug

Interactively determine the next feature slug for personal workspace in the thoughts directory structure.

How It Works

1. •

   Determine Namespace:

   • •Default to git user: git config user.name | tr '[:upper:]' '[:lower:]' | tr ' ' '-'
   • •Or accept namespace parameter
   • •Personal workspace: thoughts/{namespace}/
   • •Shared workspace: thoughts/shared/ (used by share-docs skill)
2. •

   Find Next Number:

   • •Scan thoughts/{namespace}/ directory for existing feature directories
   • •Pattern: ^[0-9]{4}-.*
   • •Find highest number and add 1
   • •Default to 0001 if no features exist
3. •

   Suggest Description:

   • •From research question: Extract key terms, convert to kebab-case
   • •From plan title: Extract feature name, convert to kebab-case
   • •Fallback: Prompt without suggestion
4. •

   Prompt User with AskUserQuestion:

   • •Show suggested slug as an option
   • •User can accept suggestion or select "Other" to provide custom description
   • •Example:
     code

     AskUserQuestion:
       question: "Choose feature slug description (will be: erik/0004-[description])"
       header: "Feature Name"
       options:
         - "authentication-system" - Suggested based on context
     

   • •Validate: Only lowercase letters, numbers, hyphens
5. •

   Return Result:

   • •Format: {namespace}/NNNN-description
   • •Create directory: thoughts/{namespace}/NNNN-description/

Example Usage

# Determine namespace (default to git user)
NAMESPACE=$(git config user.name | tr '[:upper:]' '[:lower:]' | tr ' ' '-')

# Auto-detect next number in personal namespace
NEXT_NUM=$(ls -1 thoughts/${NAMESPACE}/ 2>/dev/null | grep -E '^[0-9]{4}-' | sort -r | head -1 | cut -d'-' -f1)
NEXT_NUM=$(printf "%04d" $((10#${NEXT_NUM:-0} + 1)))

# Suggest from context (research question, plan title)
SUGGESTED_DESC=$(echo "$RESEARCH_QUESTION" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-\|-$//g')

# Prompt user with AskUserQuestion
# Present suggested slug as option, user can select "Other" for custom input
# AskUserQuestion returns the selected value
DESC="$SUGGESTED_DESC"  # Use result from AskUserQuestion

# Create directory in personal namespace
mkdir -p "thoughts/${NAMESPACE}/${NEXT_NUM}-${DESC}"
echo "${NAMESPACE}/${NEXT_NUM}-${DESC}"

Validation

• •Namespace must be valid (lowercase, hyphens, from git user.name)
• •Number must be 4 digits, zero-padded
• •Description must be kebab-case (lowercase, hyphens only)
• •Directory must not already exist in namespace
• •Description length: 3-50 characters

Collaboration Model

Personal namespace: thoughts/{username}/NNNN-slug/

• •Each developer has own numbering sequence
• •No conflicts between developers
• •Work-in-progress documents

Shared namespace: thoughts/shared/NNNN-slug/

• •Assigned by share-docs skill when publishing
• •Canonical team numbering
• •Published documents

This skill always creates documents in personal namespace. Use share-docs to promote to shared.