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
code
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:*orscope:*)
Optional Labels
- •Chain label: Only for cryptocurrency-specific code
- •Test Scope label: Only when Type is
test
Quick Reference
code
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-issuecommand - Uses this mapping for issue work