Label → Context Mapping

Central mapping from GitHub labels to Skills and Context documents.

SSOT: This skill defines the operational mappings. Label definitions are in Task Classification.

When to Use

• Creating issues: Determine which labels to apply

• Working on issues: Determine which skills and contexts to load

Label Categories

Type Labels → Context Documents

Label Context Document

bug

docs/task-contexts/bug-fix.md

enhancement

docs/task-contexts/feature-add.md

refactoring

docs/task-contexts/refactoring.md

documentation

docs/task-contexts/documentation.md

security

docs/task-contexts/security.md

technical-debt

docs/task-contexts/refactoring.md

test

docs/task-contexts/test.md

Language Labels → Skills

Label Skill Verification

lang:go

go-development

make go-lint && make tidy && make check-build && make go-test

lang:typescript

typescript-development

See skill for app-specific commands (Bun for xrpl-grpc-server, npm for eth-contracts)

lang:solidity

solidity-development

truffle compile && truffle test

Scope Labels → Skills

Label Skill Verification

scope:docs

docs-update

Markdown formatting

scope:devops

devops

yamllint , workflow test

scope:scripts

shell-scripts

make shfmt

scope:makefile

makefile-update

make mk-lint

scope:db

db-migration (+ go-development ) make atlas-fmt && make atlas-lint && make sqlc

scope:config

Syntax validation

scope:proto

make proto

Chain Labels → Context Documents

Label Context Documents

chain:btc

docs/task-contexts/chain-specific.md , docs/chains/btc/README.md

chain:bch

docs/task-contexts/chain-specific.md , docs/chains/bch/README.md

chain:eth

docs/task-contexts/chain-specific.md , docs/chains/eth/README.md

chain:erc20

docs/task-contexts/chain-specific.md , docs/chains/eth/README.md

chain:xrp

docs/task-contexts/chain-specific.md , docs/chains/xrp/README.md

chain:all

docs/task-contexts/chain-specific.md

Test Scope Labels → Verification

Label Verification

unit-test

make go-test

integration-test

make go-test-integration

e2e-test

make btc-e2e-* or chain-specific E2E

Loading Procedure

From Issue Labels

1. Parse issue labels
2. Load contexts:
   • Type label → Context document
   • Chain label → Chain context (if present)
3. Load skills:
   • Always: git-workflow
   • Lang/Scope label → Development skill
4. Apply verification commands from skill

Mapping Examples

Labels Skills Loaded Contexts Loaded

bug , lang:go , chain:btc

git-workflow , go-development

bug-fix.md, chains/btc.md

enhancement , lang:typescript , chain:xrp

git-workflow , typescript-development

feature-add.md, chains/xrp.md

documentation , scope:docs

git-workflow , docs-update

documentation.md

refactoring , scope:db , lang:go

git-workflow , db-migration , go-development

refactoring.md, db-change.md

test , lang:go , unit-test

git-workflow , go-development

test.md

security , lang:go

git-workflow , go-development

security.md

Label Selection Rules

Required Labels

Every issue must have:

• One Type label (bug , enhancement , refactoring , documentation , security , technical-debt , test )

• One Language OR Scope label (lang:* or scope:* )

Optional Labels

• Chain label: Only for cryptocurrency-specific code

• Test Scope label: Only when Type is test

Quick Reference

Required: [Type] + [Language OR Scope] Optional: [Test Scope] + [Chain]

Type label → Context document (what to do) Lang/Scope label → Skill (how to do) Chain label → Chain context (domain knowledge)

Related

• Task Classification SSOT - Label definitions

• GitHub Labels - Label configuration

• github-issue-creation

• Uses this mapping for issue creation

• fix-issue command - Uses this mapping for issue work