tag-command-mapping

How tag-to-command routing works in autopilot. Defines default mappings, precedence rules, and customization patterns.

Repository: MadAppGang/claude-code
Last source activity: January 20, 2026 at 08:16
Detected SKILL.md language: English
Stars: 278
Forks: 29

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/MadAppGang/claude-code --skill tag-command-mapping

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

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';
}

---
tag_mappings:
  "@database":
    command: "/dev:implement"
    agent: "developer"
    skills: ["database-patterns"]
    systemPrompt: "You are a database specialist."

  "@performance":
    command: "/dev:implement"
    agent: "developer"
    skills: ["universal-patterns"]
    systemPrompt: "You are a performance optimization expert."
---

function classifyTask(title: string, description: string): string {
  const text = `${title} ${description}`.toLowerCase();

  // Keyword patterns
  if (/\b(fix|bug|error|crash|broken)\b/.test(text)) return 'BUG_FIX';
  if (/\b(add|implement|create|new|feature)\b/.test(text)) return 'FEATURE';
  if (/\b(refactor|clean|optimize|improve)\b/.test(text)) return 'REFACTOR';
  if (/\b(ui|design|component|style|visual)\b/.test(text)) return 'UI_CHANGE';
  if (/\b(test|coverage|e2e|spec)\b/.test(text)) return 'TEST';
  if (/\b(doc|documentation|readme)\b/.test(text)) return 'DOCUMENTATION';

  return 'UNKNOWN';
}

function resolveMapping(labels: string[], title: string, desc: string) {
  // 1. Check explicit tags
  const tag = selectTag(labels);

  if (tag !== 'default') {
    return getMappingForTag(tag);
  }

  // 2. Classify from text
  const taskType = classifyTask(title, desc);

  // 3. Map task type to default tag
  const typeToTag = {
    'BUG_FIX': '@debug',
    'FEATURE': '@frontend',
    'UI_CHANGE': '@ui',
    'TEST': '@test',
    'REFACTOR': '@refactor',
    'DOCUMENTATION': '@research',
  };

  return getMappingForTag(typeToTag[taskType] || '@frontend');
}

// Task with @frontend label
const labels = ['@frontend', 'feature'];
const tag = selectTag(labels);  // '@frontend'
const mapping = getMappingForTag(tag);
// Result: { command: '/dev:feature', agent: 'developer', skills: ['react-typescript'] }

// Task with both @frontend and @debug
const labels = ['@frontend', '@debug'];
const tag = selectTag(labels);  // '@debug' (higher precedence)
const mapping = getMappingForTag(tag);
// Result: { command: '/dev:debug', agent: 'debugger', skills: ['debugging-strategies'] }

// Task without tags
const labels = [];
const title = "Fix login button not working";
const mapping = resolveMapping(labels, title, "");
// Classifies as BUG_FIX -> @debug
// Result: { command: '/dev:debug', agent: 'debugger', skills: ['debugging-strategies'] }

name	tag-command-mapping
description	How tag-to-command routing works in autopilot. Defines default mappings, precedence rules, and customization patterns.
version	0.1.0
tags	["routing","tags","commands","mapping"]
keywords	["tag","command","mapping","routing","classification","precedence"]

name	tag-command-mapping
description	How tag-to-command routing works in autopilot. Defines default mappings, precedence rules, and customization patterns.
version	0.1.0
tags	["routing","tags","commands","mapping"]
keywords	["tag","command","mapping","routing","classification","precedence"]

tag-command-mapping

Install options

Review the source files

Tag-to-Command Mapping

When to Use

Overview

Default Mappings

Tag-to-Command Mapping

When to Use

Overview

Default Mappings

Precedence Rules

Custom Mappings

Task Classification

Mapping Resolution

Examples

Example 1: Single Tag Resolution

Example 2: Multiple Tag Precedence

Example 3: Text Classification Fallback

Best Practices

@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

tag-command-mapping

Source facts

Install options

Review the source files

More from this repository

Tag-to-Command Mapping

When to Use

Overview

Default Mappings

More from this repository

Tag-to-Command Mapping

When to Use

Overview

Default Mappings

Precedence Rules

Custom Mappings

Task Classification

Mapping Resolution

Examples

Example 1: Single Tag Resolution

Example 2: Multiple Tag Precedence

Example 3: Text Classification Fallback

Best Practices