nicolas-codemate/analyze-ticket

Analyze Ticket Skill

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

Complexity Levels

| Level | Score | Exploration | Planning | AEP | Architect | |-------|-------|-------------|----------|-----|-----------| | SIMPLE | 0-2 | Skip | Basic | No | No | | MEDIUM | 3-5 | Light | Standard | Partial | Optional | | COMPLEX | 6+ | Full AEP | Detailed | Full | Yes |

Scoring Factors

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

Technical Complexity

| Factor | Points | Detection Signals | |--------|--------|-------------------| | Multi-component changes | +2 | Mentions multiple services, modules, or layers | | Database schema changes | +2 | Keywords: migration, schema, table, column, index | | API breaking changes | +3 | Keywords: breaking, deprecate, remove endpoint, change contract | | New external dependency | +2 | Keywords: integrate, new library, third-party, SDK | | Performance requirements | +2 | Keywords: optimize, performance, latency, throughput | | Security implications | +2 | Keywords: auth, permission, encryption, sensitive data |

Scope Indicators

| Factor | Points | Detection Signals | |--------|--------|-------------------| | Cross-team coordination | +2 | Mentions other teams, external dependencies | | Multiple file types | +1 | Backend + frontend, or multiple languages | | Test infrastructure changes | +1 | Keywords: test framework, CI/CD, pipeline | | Documentation required | +1 | Explicit doc requirements or public API changes |

Uncertainty Factors

| Factor | Points | Detection Signals | |--------|--------|-------------------| | Vague requirements | +2 | Ambiguous language, missing acceptance criteria | | Research needed | +2 | Keywords: investigate, explore, POC, spike | | Unknown impact | +2 | Cannot determine affected components | | No clear success criteria | +1 | Missing "done when" or validation steps |

Negative Factors (Reduce Complexity)

| Factor | Points | Detection Signals | |--------|--------|-------------------| | Well-defined scope | -1 | Clear, specific requirements | | Single file change | -1 | Obvious single-file fix | | Existing pattern | -1 | Similar to existing code/feature | | Has acceptance criteria | -1 | Clear validation steps provided |

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.