tag-command-mapping

plugin: autopilot updated: 2026-01-20

Tag-to-Command Mapping

Version: 0.1.0 Purpose: Route Linear tasks to appropriate Claude Code commands based on tags Status: Phase 1

When to Use

Use this skill when you need to:

• Understand how Linear tags map to Claude Code commands
• Customize tag-to-command mappings for a project
• Handle tasks with multiple tags (precedence rules)
• Classify tasks based on title/description text
• Resolve the correct agent/command for a task

Overview

Tag-to-command mapping is the core routing mechanism in autopilot. When a task arrives from Linear, its labels determine which Claude Code command/agent handles execution.

Default Mappings

Linear Tag	Command	Agent	Skills
@frontend	/dev:feature	developer	react-typescript
@backend	/dev:implement	developer	golang, api-design
@debug	/dev:debug	debugger	debugging-strategies
@test	/dev:test-architect	test-architect	testing-strategies
@review	/commit-commands:commit-push-pr	reviewer	universal-patterns
@refactor	/dev:implement	developer	universal-patterns
@research	/dev:deep-research	researcher	n/a
@ui	/dev:ui	ui	ui-design-review

Precedence Rules

When multiple tags are present, apply precedence order:

const PRECEDENCE = [
  '@debug',    // Bug fixing takes priority
  '@test',     // Tests before implementation
  '@ui',       // UI before generic frontend
  '@frontend', // Frontend before generic
  '@backend',  // Backend before generic
  '@review',   // Review after implementation
  '@refactor', // Refactoring is lower priority
  '@research'  // Research is lowest
];

function selectTag(labels: string[]): string {
  const agentTags = labels.filter(l => l.startsWith('@'));

  if (agentTags.length === 0) return 'default';
  if (agentTags.length === 1) return agentTags[0];

  // Multiple tags - apply precedence
  for (const tag of PRECEDENCE) {
    if (agentTags.includes(tag)) return tag;
  }

  return 'default';
}