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:
- 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 creationfix-issue command - Uses this mapping for issue work
1---2name: label-context-mapping3description: Maps GitHub labels to Skills and Context documents. Use when creating issues (github-issue-creation) or working on issues (fix-issue command).4---56# Label → Context Mapping78Central mapping from GitHub labels to Skills and Context documents.910**SSOT**: This skill defines the operational mappings. Label definitions are in [Task Classification](../../../docs/guidelines/task-classification.md).1112## When to Use1314- **Creating issues**: Determine which labels to apply15- **Working on issues**: Determine which skills and contexts to load1617## Label Categories1819### Type Labels → Context Documents2021| Label | Context Document |22| ---------------- | ------------------------------------- |23| `bug` | `docs/ai/task-contexts/bug-fix.md` |24| `enhancement` | `docs/ai/task-contexts/feature-add.md` |25| `refactoring` | `docs/ai/task-contexts/refactoring.md` |26| `documentation` | `docs/ai/task-contexts/documentation.md` |27| `security` | `docs/ai/task-contexts/security.md` |28| `technical-debt` | `docs/ai/task-contexts/refactoring.md` |29| `test` | `docs/ai/task-contexts/test.md` |3031### Language Labels → Skills3233| Label | Skill | Verification |34| ----------------- | ------------------------ | ----------------------------------------------------------------------------------- |35| `lang:go` | `go-development` | `make go-lint && make tidy && make check-build && make go-test` |36| `lang:typescript` | `typescript-development` | See skill for app-specific commands (Bun for xrpl-grpc-server, npm for eth-contracts) |37| `lang:solidity` | `solidity-development` | `truffle compile && truffle test` |3839### Scope Labels → Skills4041| Label | Skill | Verification |42| ---------------- | ----------------------------------- | ------------------------------------------------ |43| `scope:docs` | `docs-update` | Markdown formatting |44| `scope:devops` | `devops` | `yamllint`, workflow test |45| `scope:scripts` | `shell-scripts` | `make shfmt` |46| `scope:makefile` | `makefile-update` | `make mk-lint` |47| `scope:db` | `db-migration` (+ `go-development`) | `make atlas-fmt && make atlas-lint && make sqlc` |48| `scope:config` | - | Syntax validation |49| `scope:proto` | - | `make proto` |5051### Chain Labels → Context Documents5253| Label | Context Documents |54| ------------- | ------------------------------------------------------------------- |55| `chain:btc` | `docs/ai/task-contexts/chain-specific.md`, `docs/chains/btc/README.md` |56| `chain:bch` | `docs/ai/task-contexts/chain-specific.md`, `docs/chains/bch/README.md` |57| `chain:eth` | `docs/ai/task-contexts/chain-specific.md`, `docs/chains/eth/README.md` |58| `chain:erc20` | `docs/ai/task-contexts/chain-specific.md`, `docs/chains/eth/README.md` |59| `chain:xrp` | `docs/ai/task-contexts/chain-specific.md`, `docs/chains/xrp/README.md` |60| `chain:all` | `docs/ai/task-contexts/chain-specific.md` |6162### Test Scope Labels → Verification6364| Label | Verification |65| ------------------ | -------------------------------------- |66| `unit-test` | `make go-test` |67| `integration-test` | `make go-test-integration` |68| `e2e-test` | `make btc-e2e-*` or chain-specific E2E |6970## Loading Procedure7172### From Issue Labels7374```751. Parse issue labels762. Load contexts:77 - Type label → Context document78 - Chain label → Chain context (if present)793. Load skills:80 - Always: git-workflow81 - Lang/Scope label → Development skill824. Apply verification commands from skill83```8485### Mapping Examples8687| Labels | Skills Loaded | Contexts Loaded |88| --------------------------------------------- | ------------------------------------------------ | ----------------------------- |89| `bug`, `lang:go`, `chain:btc` | `git-workflow`, `go-development` | bug-fix.md, chains/btc.md |90| `enhancement`, `lang:typescript`, `chain:xrp` | `git-workflow`, `typescript-development` | feature-add.md, chains/xrp.md |91| `documentation`, `scope:docs` | `git-workflow`, `docs-update` | documentation.md |92| `refactoring`, `scope:db`, `lang:go` | `git-workflow`, `db-migration`, `go-development` | refactoring.md, db-change.md |93| `test`, `lang:go`, `unit-test` | `git-workflow`, `go-development` | test.md |94| `security`, `lang:go` | `git-workflow`, `go-development` | security.md |9596## Label Selection Rules9798### Required Labels99100Every issue must have:1011021. **One Type label** (`bug`, `enhancement`, `refactoring`, `documentation`, `security`, `technical-debt`, `test`)1032. **One Language OR Scope label** (`lang:*` or `scope:*`)104105### Optional Labels106107- **Chain label**: Only for cryptocurrency-specific code108- **Test Scope label**: Only when Type is `test`109110## Quick Reference111112```113Required: [Type] + [Language OR Scope]114Optional: [Test Scope] + [Chain]115116Type label → Context document (what to do)117Lang/Scope label → Skill (how to do)118Chain label → Chain context (domain knowledge)119```120121## Related122123- [Task Classification SSOT](../../../docs/guidelines/task-classification.md) - Label definitions124- [GitHub Labels](.github/labels.yml) - Label configuration125- `github-issue-creation` - Uses this mapping for issue creation126- `fix-issue` command - Uses this mapping for issue work
hiromaily