Analyze Ticket Skill

This skill analyzes a ticket's content to determine its complexity and decide which workflow phases are required.

Complexity Levels

Scoring Factors

Analyze the ticket content and assign points for each applicable factor:

Technical Complexity

Scope Indicators

Uncertainty Factors

Negative Factors (Reduce Complexity)

Label-Based Override

Certain labels can force complexity level:

Simple Labels (force SIMPLE)

• •quick-fix, typo, documentation, trivial, minor
• •Config: complexity.simple_labels

Complex Labels (force COMPLEX)

• •needs-analysis, architecture, breaking-change, migration, epic
• •Config: complexity.complex_labels

Analysis Process

Step 1: Extract Keywords

Parse ticket content for complexity signals:

• •Title
• •Description
• •Labels/Tags
• •Comments (if available)

Step 2: Calculate Base Score

Sum points from all applicable factors.

Step 3: Apply Label Override

Check for forcing labels that override calculated score.

Step 4: Determine Level

if has_simple_label:
    level = SIMPLE
elif has_complex_label:
    level = COMPLEX
elif score <= simple_threshold (default: 2):
    level = SIMPLE
elif score >= complex_threshold (default: 6):
    level = COMPLEX
else:
    level = MEDIUM

Step 5: Recommend Actions

Based on complexity level, recommend workflow phases:

SIMPLE

• •Skip exploration phase
• •Create direct implementation plan
• •No AEP methodology
• •Basic validation only

MEDIUM

• •Light exploration (1 agent, focused search)
• •Standard implementation plan
• •Partial AEP (Analyse + Plan, skip deep Explore)
• •Standard validation

COMPLEX

• •Full AEP workflow (3 parallel explore agents)
• •Invoke Architect skill for planning
• •Detailed implementation plan with phases
• •Comprehensive validation strategy

Output Format

## Complexity Analysis

### Score Breakdown

| Factor | Points | Reason |
|--------|--------|--------|
| Multi-component changes | +2 | Affects API and frontend |
| Database changes | +2 | Requires migration |
| Well-defined scope | -1 | Clear acceptance criteria |
| **Total** | **3** | |

### Classification

**Complexity Level**: MEDIUM (score: 3)

### Label Analysis
- Labels found: `feature`, `backend`
- No complexity-forcing labels detected

### Recommended Workflow

1. **Exploration**: Light (1 focused agent)
2. **Planning**: Standard approach
3. **AEP**: Partial (Analyse + Plan)
4. **Architect Skill**: Optional

### Key Concerns

- Database migration requires careful ordering
- Consider rollback strategy for schema changes

### Suggested Focus Areas

1. Existing migration patterns in codebase
2. Related API endpoints
3. Test coverage for affected components

Integration with Workflow

This skill is invoked by:

1. •/resolve command - after fetch, before workspace setup
2. •/analyze-ticket standalone command
3. •Planning phase to determine approach

Configuration

Reads from .claude/ticket-config.json:

{
  "complexity": {
    "auto_detect": true,
    "simple_labels": ["quick-fix", "typo"],
    "complex_labels": ["architecture", "migration"],
    "simple_threshold": 2,
    "complex_threshold": 6
  }
}

Exploration Guidelines by Level

SIMPLE - No Exploration

Proceed directly to implementation planning.

MEDIUM - Light Exploration

Launch 1 explore agent to:

• •Find similar existing code
• •Identify files to modify
• •Check test patterns

COMPLEX - Full AEP Exploration

Launch up to 3 parallel explore agents:

Agent 1: Implementation Patterns

• •Search for similar features
• •Find reusable code patterns
• •Identify coding conventions

Agent 2: Impact Analysis

• •Trace dependencies
• •Find all affected components
• •Check for breaking changes

Agent 3: Test Coverage

• •Find related tests
• •Check testing patterns
• •Identify test utilities

Language

Analysis output in French for user communication. Technical terms and factor names in English.