Determine Feature Slug

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:

     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.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.