@@ -15,40 +15,40 @@ This document describes the label system for plugin-dev.
1515
1616Standard GitHub labels for issue/PR classification:
1717
18- | Label | Color | Description |
19- | --------------- | -------------------------------------------------------- | -------------------------------------- |
20- | ` bug ` | ![ #d73a4a] ( https://placehold.co/15x15/d73a4a/d73a4a.png ) | Something isn't working |
21- | ` documentation ` | ![ #0075ca] ( https://placehold.co/15x15/0075ca/0075ca.png ) | Improvements or additions |
22- | ` duplicate ` | ![ #cfd3d7] ( https://placehold.co/15x15/cfd3d7/cfd3d7.png ) | Already exists |
23- | ` enhancement ` | ![ #a2eeef] ( https://placehold.co/15x15/a2eeef/a2eeef.png ) | New feature or request |
24- | ` invalid ` | ![ #e4e669] ( https://placehold.co/15x15/e4e669/e4e669.png ) | Doesn't seem right |
25- | ` question ` | ![ #d876e3] ( https://placehold.co/15x15/d876e3/d876e3.png ) | Further information requested |
18+ | Label | Color | Description |
19+ | --------------- | -------------------------------------------------------- | ------------------------------------------ |
20+ | ` bug ` | ![ #d73a4a] ( https://placehold.co/15x15/d73a4a/d73a4a.png ) | Something isn't working |
21+ | ` documentation ` | ![ #0075ca] ( https://placehold.co/15x15/0075ca/0075ca.png ) | Improvements or additions |
22+ | ` duplicate ` | ![ #cfd3d7] ( https://placehold.co/15x15/cfd3d7/cfd3d7.png ) | Already exists |
23+ | ` enhancement ` | ![ #a2eeef] ( https://placehold.co/15x15/a2eeef/a2eeef.png ) | New feature or request |
24+ | ` invalid ` | ![ #e4e669] ( https://placehold.co/15x15/e4e669/e4e669.png ) | Doesn't seem right |
25+ | ` question ` | ![ #d876e3] ( https://placehold.co/15x15/d876e3/d876e3.png ) | Further information requested |
2626| ` refactor ` | ![ #fef65b] ( https://placehold.co/15x15/fef65b/fef65b.png ) | Code restructuring without behavior change |
27- | ` chore ` | ![ #c5def5] ( https://placehold.co/15x15/c5def5/c5def5.png ) | Maintenance tasks |
28- | ` wontfix ` | ![ #ffffff] ( https://placehold.co/15x15/ffffff/ffffff.png ) | Will not be worked on |
27+ | ` chore ` | ![ #c5def5] ( https://placehold.co/15x15/c5def5/c5def5.png ) | Maintenance tasks |
28+ | ` wontfix ` | ![ #ffffff] ( https://placehold.co/15x15/ffffff/ffffff.png ) | Will not be worked on |
2929
3030### Component Labels
3131
3232Identify which part of the codebase (cool blue/purple tones):
3333
34- | Label | Color | Description |
35- | ----------------------- | -------------------------------------------------------- | ------------------------ |
36- | ` component:agent ` | ![ #0052cc] ( https://placehold.co/15x15/0052cc/0052cc.png ) | Agents layer |
37- | ` component:command ` | ![ #5319e7] ( https://placehold.co/15x15/5319e7/5319e7.png ) | Commands layer |
38- | ` component:docs ` | ![ #d4c5f9] ( https://placehold.co/15x15/d4c5f9/d4c5f9.png ) | Documentation files |
39- | ` component:hook ` | ![ #006b75] ( https://placehold.co/15x15/006b75/006b75.png ) | Hooks layer |
40- | ` component:skill ` | ![ #1d76db] ( https://placehold.co/15x15/1d76db/1d76db.png ) | Skills layer |
41- | ` component:marketplace ` | ![ #0366d6] ( https://placehold.co/15x15/0366d6/0366d6.png ) | Marketplace manifest |
42- | ` component:mcp ` | ![ #032f62] ( https://placehold.co/15x15/032f62/032f62.png ) | MCP integration |
34+ | Label | Color | Description |
35+ | ----------------------- | -------------------------------------------------------- | -------------------- |
36+ | ` component:agent ` | ![ #0052cc] ( https://placehold.co/15x15/0052cc/0052cc.png ) | Agents layer |
37+ | ` component:command ` | ![ #5319e7] ( https://placehold.co/15x15/5319e7/5319e7.png ) | Commands layer |
38+ | ` component:docs ` | ![ #d4c5f9] ( https://placehold.co/15x15/d4c5f9/d4c5f9.png ) | Documentation files |
39+ | ` component:hook ` | ![ #006b75] ( https://placehold.co/15x15/006b75/006b75.png ) | Hooks layer |
40+ | ` component:skill ` | ![ #1d76db] ( https://placehold.co/15x15/1d76db/1d76db.png ) | Skills layer |
41+ | ` component:marketplace ` | ![ #0366d6] ( https://placehold.co/15x15/0366d6/0366d6.png ) | Marketplace manifest |
42+ | ` component:mcp ` | ![ #032f62] ( https://placehold.co/15x15/032f62/032f62.png ) | MCP integration |
4343
4444### Scope Labels
4545
4646Labels for plugin development concerns (warm coral/pink family):
4747
48- | Label | Color | Description |
49- | ------------------ | -------------------------------------------------------- | -------------------------------- |
48+ | Label | Color | Description |
49+ | ------------------ | -------------------------------------------------------- | --------------------------------- |
5050| ` scope:triggering ` | ![ #e91e63] ( https://placehold.co/15x15/e91e63/e91e63.png ) | Trigger phrase/description issues |
51- | ` scope:validation ` | ![ #f44336] ( https://placehold.co/15x15/f44336/f44336.png ) | Plugin validation concerns |
51+ | ` scope:validation ` | ![ #f44336] ( https://placehold.co/15x15/f44336/f44336.png ) | Plugin validation concerns |
5252
5353### Priority Labels
5454
@@ -87,12 +87,12 @@ Time estimates:
8787
8888### Community Labels
8989
90- | Label | Color | Description |
91- | ------------------ | -------------------------------------------------------- | -------------------- |
92- | ` good first issue ` | ![ #7057ff] ( https://placehold.co/15x15/7057ff/7057ff.png ) | Good for newcomers |
93- | ` help wanted ` | ![ #008672 ] ( https://placehold.co/15x15/008672/008672.png ) | Extra attention needed |
90+ | Label | Color | Description |
91+ | ------------------ | -------------------------------------------------------- | -------------------------- |
92+ | ` good first issue ` | ![ #7057ff] ( https://placehold.co/15x15/7057ff/7057ff.png ) | Good for newcomers |
93+ | ` help wanted ` | ![ #008672 ] ( https://placehold.co/15x15/008672/008672.png ) | Extra attention needed |
9494| ` idea ` | ![ #f9a825] ( https://placehold.co/15x15/f9a825/f9a825.png ) | Feature idea or suggestion |
95- | ` showcase ` | ![ #6f42c1] ( https://placehold.co/15x15/6f42c1/6f42c1.png ) | Community showcase |
95+ | ` showcase ` | ![ #6f42c1] ( https://placehold.co/15x15/6f42c1/6f42c1.png ) | Community showcase |
9696
9797### Dependency Labels
9898
@@ -105,28 +105,28 @@ Time estimates:
105105
106106Type of change:
107107
108- | Label | Color | Description |
109- | -------------- | -------------------------------------------------------- | -------------------------------- |
110- | ` breaking ` | ![ #bd2130] ( https://placehold.co/15x15/bd2130/bd2130.png ) | Breaking change (major version) |
111- | ` automation ` | ![ #28a745] ( https://placehold.co/15x15/28a745/28a745.png ) | CI/CD and workflow improvements |
112- | ` optimization ` | ![ #2188ff] ( https://placehold.co/15x15/2188ff/2188ff.png ) | Performance improvements |
108+ | Label | Color | Description |
109+ | -------------- | -------------------------------------------------------- | ------------------------------- |
110+ | ` breaking ` | ![ #bd2130] ( https://placehold.co/15x15/bd2130/bd2130.png ) | Breaking change (major version) |
111+ | ` automation ` | ![ #28a745] ( https://placehold.co/15x15/28a745/28a745.png ) | CI/CD and workflow improvements |
112+ | ` optimization ` | ![ #2188ff] ( https://placehold.co/15x15/2188ff/2188ff.png ) | Performance improvements |
113113
114114### Workflow Labels
115115
116- | Label | Color | Description |
117- | ---------- | -------------------------------------------------------- | ---------------------- |
118- | ` triage ` | ![ #ededed] ( https://placehold.co/15x15/ededed/ededed.png ) | Needs initial review |
119- | ` stale ` | ![ #ededed] ( https://placehold.co/15x15/ededed/ededed.png ) | No recent activity |
120- | ` pinned ` | ![ #fef2c0] ( https://placehold.co/15x15/fef2c0/fef2c0.png ) | Never mark as stale |
121- | ` roadmap ` | ![ #0e8a16] ( https://placehold.co/15x15/0e8a16/0e8a16.png ) | Long-term roadmap item |
116+ | Label | Color | Description |
117+ | --------- | -------------------------------------------------------- | ---------------------- |
118+ | ` triage ` | ![ #ededed] ( https://placehold.co/15x15/ededed/ededed.png ) | Needs initial review |
119+ | ` stale ` | ![ #ededed] ( https://placehold.co/15x15/ededed/ededed.png ) | No recent activity |
120+ | ` pinned ` | ![ #fef2c0] ( https://placehold.co/15x15/fef2c0/fef2c0.png ) | Never mark as stale |
121+ | ` roadmap ` | ![ #0e8a16] ( https://placehold.co/15x15/0e8a16/0e8a16.png ) | Long-term roadmap item |
122122
123123### Special Labels
124124
125- | Label | Color | Description |
126- | ------------ | -------------------------------------------------------- | --------------------------- |
127- | ` experiment ` | ![ #ff6ec7] ( https://placehold.co/15x15/ff6ec7/ff6ec7.png ) | Experimental/testing |
128- | ` security ` | ![ #ee0701] ( https://placehold.co/15x15/ee0701/ee0701.png ) | Security-related |
129- | ` reverted ` | ![ #666666 ] ( https://placehold.co/15x15/666666/666666.png ) | Merged but later reverted |
125+ | Label | Color | Description |
126+ | ------------ | -------------------------------------------------------- | ------------------------- |
127+ | ` experiment ` | ![ #ff6ec7] ( https://placehold.co/15x15/ff6ec7/ff6ec7.png ) | Experimental/testing |
128+ | ` security ` | ![ #ee0701] ( https://placehold.co/15x15/ee0701/ee0701.png ) | Security-related |
129+ | ` reverted ` | ![ #666666 ] ( https://placehold.co/15x15/666666/666666.png ) | Merged but later reverted |
130130
131131## Label Application Guidelines
132132
@@ -152,17 +152,17 @@ Apply when relevant:
152152
153153Common label combinations for plugin-dev:
154154
155- | Scenario | Labels |
156- | --------------------------- | ----------------------------------------------------- |
157- | Skill not triggering | ` bug ` , ` component:skill ` , ` scope:triggering ` |
158- | New agent feature | ` enhancement ` , ` component:agent ` , ` priority:* ` |
159- | Marketplace manifest issue | ` bug ` , ` component:marketplace ` , ` priority:* ` |
160- | Validation script fix | ` bug ` , ` component:docs ` , ` automation ` |
161- | MCP integration enhancement | ` enhancement ` , ` component:mcp ` , ` effort:* ` |
162- | Hook development docs | ` documentation ` , ` component:hook ` , ` effort:small ` |
163- | Command triggering bug | ` bug ` , ` component:command ` , ` scope:triggering ` |
164- | Plugin architecture design | ` enhancement ` , ` status:needs-design ` , ` roadmap ` |
165- | Dependabot PR | ` chore ` , ` dependencies ` , ` effort:small ` |
155+ | Scenario | Labels |
156+ | --------------------------- | ------------------------------------------------- |
157+ | Skill not triggering | ` bug ` , ` component:skill ` , ` scope:triggering ` |
158+ | New agent feature | ` enhancement ` , ` component:agent ` , ` priority:* ` |
159+ | Marketplace manifest issue | ` bug ` , ` component:marketplace ` , ` priority:* ` |
160+ | Validation script fix | ` bug ` , ` component:docs ` , ` automation ` |
161+ | MCP integration enhancement | ` enhancement ` , ` component:mcp ` , ` effort:* ` |
162+ | Hook development docs | ` documentation ` , ` component:hook ` , ` effort:small ` |
163+ | Command triggering bug | ` bug ` , ` component:command ` , ` scope:triggering ` |
164+ | Plugin architecture design | ` enhancement ` , ` status:needs-design ` , ` roadmap ` |
165+ | Dependabot PR | ` chore ` , ` dependencies ` , ` effort:small ` |
166166
167167## Automatic Label Application
168168
@@ -178,15 +178,15 @@ The `semantic-labeler.yml` workflow:
178178
179179### Labels Applied Automatically
180180
181- | Category | Labels | Required |
182- | --------- | ----------------------------------------------------------- | ------------- |
183- | Type | bug, enhancement, documentation, question, refactor, chore | Yes (one) |
184- | Component | component:\* , github-actions, dependencies | If applicable |
185- | Scope | scope: triggering , scope: validation | If applicable |
186- | Priority | priority: critical /high/medium/low | Yes (one) |
187- | Effort | effort: small /medium/large | Yes (one) |
188- | Impact | breaking, security | If applicable |
189- | Community | good first issue, help wanted | If applicable |
181+ | Category | Labels | Required |
182+ | --------- | ---------------------------------------------------------- | ------------- |
183+ | Type | bug, enhancement, documentation, question, refactor, chore | Yes (one) |
184+ | Component | component:\* , github-actions, dependencies | If applicable |
185+ | Scope | scope: triggering , scope: validation | If applicable |
186+ | Priority | priority: critical /high/medium/low | Yes (one) |
187+ | Effort | effort: small /medium/large | Yes (one) |
188+ | Impact | breaking, security | If applicable |
189+ | Community | good first issue, help wanted | If applicable |
190190
191191### Skipped Cases
192192
@@ -235,16 +235,16 @@ Deleting labels requires manual action - the automated workflow only creates and
235235
236236## Color Scheme Rationale
237237
238- | Category | Color Family | Rationale |
239- | ---------- | ---------------------- | -------------------------------------------- |
240- | Type | GitHub defaults | Familiar to all GitHub users |
241- | Component | Cool blues/purples | Technical, structural feel |
242- | Scope | Warm coral/pink | Distinct from components, user-facing issues |
243- | Priority | Heat map (red → green) | Intuitive urgency indication |
244- | Status | Soft pastels | Non-distracting state indicators |
245- | Effort | Green → red gradient | Easy (green) to hard (red) |
246- | Category | Semantic colors | Breaking=red, automation=green |
247- | Workflow | Neutral greys | Background process labels |
238+ | Category | Color Family | Rationale |
239+ | --------- | ---------------------- | -------------------------------------------- |
240+ | Type | GitHub defaults | Familiar to all GitHub users |
241+ | Component | Cool blues/purples | Technical, structural feel |
242+ | Scope | Warm coral/pink | Distinct from components, user-facing issues |
243+ | Priority | Heat map (red → green) | Intuitive urgency indication |
244+ | Status | Soft pastels | Non-distracting state indicators |
245+ | Effort | Green → red gradient | Easy (green) to hard (red) |
246+ | Category | Semantic colors | Breaking=red, automation=green |
247+ | Workflow | Neutral greys | Background process labels |
248248
249249## Label Naming Conventions
250250
0 commit comments