issue-create

Create Issue

Create a new GitHub issue following project conventions with all metadata properly configured.

Usage

/issue-create "Add validation for hook matchers"
/issue-create                                      # Interactive mode

Arguments

• First argument (optional): Issue title. If omitted, prompts for title.

What This Does

Creates an issue with all factors properly configured:

1. Title - Validates naming conventions (no type prefixes)
2. Labels - Applies type, priority, scope, and branch labels
3. Milestone - Optionally assigns to milestone
4. Relationships - Links to parent, blocking, or related issues
5. Project - Adds to project board with initial status
6. Body - Includes structured template with acceptance criteria

Workflow

Step 0: Load Environment and Detect Scope

Before any prompts, load the environment and attempt scope detection:

# Load environment
ENV_FILE=".claude/github-workflows/env.json"
if [[ -f "$ENV_FILE" ]]; then
    DETECTED_SCOPE=$(jq -r '.branch.scopeLabel // empty' "$ENV_FILE")
    SUGGESTED_SCOPES=$(jq -r '.labels.suggestedScopes[]? // empty' "$ENV_FILE")
fi

# If no scope from env, try branch name
if [[ -z "$DETECTED_SCOPE" ]]; then
    BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
    # Match branch against suggested scopes
    for scope in $SUGGESTED_SCOPES; do
        if [[ "${BRANCH,,}" == *"${scope,,}"* ]]; then
            DETECTED_SCOPE="scope:$scope"
            break
        fi
    done
fi

Step 1: Title Validation

Check title follows conventions:

• No type prefixes like [BUG], [FEATURE], [ENHANCEMENT]
• Descriptive and actionable
• 50-72 characters recommended

❌ "[BUG] Login fails" → Suggest: "Fix login authentication failure"
❌ "[FEATURE] Add auth" → Suggest: "Add user authentication"
✅ "Add validation for hook matchers"

Step 2: Label Selection

Prompt for each label dimension:

Type (required):

Select issue type:
1. bug - Something isn't working
2. feature - New functionality
3. enhancement - Improve existing feature
4. documentation - Documentation changes
5. refactor - Code improvement
6. chore - Maintenance task

Your choice: _