label-context-mapping

name	label-context-mapping
description	Maps GitHub labels to Skills and Context documents. Use when creating issues (github-issue-creation) or working on issues (fix-issue command).

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/ai/task-contexts/bug-fix.md
enhancement	docs/ai/task-contexts/feature-add.md
refactoring	docs/ai/task-contexts/refactoring.md
documentation	docs/ai/task-contexts/documentation.md
security	docs/ai/task-contexts/security.md
technical-debt	docs/ai/task-contexts/refactoring.md
test	docs/ai/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/ai/task-contexts/chain-specific.md, docs/chains/btc/README.md
chain:bch	docs/ai/task-contexts/chain-specific.md, docs/chains/bch/README.md
chain:eth	docs/ai/task-contexts/chain-specific.md, docs/chains/eth/README.md
chain:erc20	docs/ai/task-contexts/chain-specific.md, docs/chains/eth/README.md
chain:xrp	docs/ai/task-contexts/chain-specific.md, docs/chains/xrp/README.md
chain:all	docs/ai/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:

1. One Type label (bug, enhancement, refactoring, documentation, security, technical-debt, test)
2. 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