Title: Implement /assign self-assignment for good first issue issues · Issue #62 · learningequality/.github · GitHub
Open Graph Title: Implement /assign self-assignment for good first issue issues · Issue #62 · learningequality/.github
X Title: Implement /assign self-assignment for good first issue issues · Issue #62 · learningequality/.github
Description: ❌ This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues. Overview Implement the /assign self-assignment mechanism for good first issue issues, as ag...
Open Graph Description: ❌ This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues. Overview Implement the /assign self-assignment mech...
X Description: ❌ This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues. Overview Implement the /assign self-assignment mech...
Opengraph URL: https://github.com/learningequality/.github/issues/62
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Implement /assign self-assignment for good first issue issues","articleBody":"\u003c!---HEADER START-->\n\n\u003cimg height=\"20px\" src=\"https://i.imgur.com/c7hUeb5.jpeg\">\n\n❌ **This issue is not open for contribution. Visit \u003ca href=\"https://learningequality.org/contributing-to-our-open-code-base/\" target=\"_blank\">Contributing guidelines\u003c/a>** to learn about the contributing process and how to find suitable issues.\n\n\u003cimg height=\"20px\" src=\"https://i.imgur.com/c7hUeb5.jpeg\">\n\n\u003c!---HEADER END-->\n\n## Overview\n\nImplement the `/assign` self-assignment mechanism for `good first issue` issues, as agreed in #47.\n\n**Complexity:** High\n**Target branch:** main\n\n### Context\n\nIssue #47 proposed a `/assign` slash command for contributor self-assignment on `help wanted` issues. After discussion, the scope was narrowed and refined:\n\n- Self-assignment is restricted to issues labeled both `help wanted` and `good first issue` (not all `help wanted` issues)\n- Bot posts guidance as an issue comment when `good first issue` label is applied, rather than modifying issue headers\n- When a contributor comments on a `help wanted` issue that is NOT `good first issue`, the bot declines and explains that only `good first issue` issues support self-assignment\n- Notifications for bot activity go to `#support-dev-notifications`, not `#support-dev`\n- The existing keyword detection for assignment requests is preserved for non-`good first issue` issues\n- Contributors are limited to 2 assigned issues across all community repos, with a 7-day cooldown on recently unassigned issues\n- Implementation extends the existing `contributor-issue-comment` script\n\n### The Change\n\n**1. Guidance comment on `good first issue` labeling**\n\nWhen the `good first issue` label is applied to an issue, the bot posts a comment explaining:\n- The issue can be self-assigned via `/assign`\n- Contributors should link open PRs to assigned issues\n- The 2-issue limit and 7-day cooldown on recently dropped issues\n- Link to the contributing guidelines\n\nThis is triggered via the `manage-issue-header` workflow, which already handles label events.\n\n**2. `/assign` command handling in `contributor-issue-comment`**\n\nWhen a contributor comments `/assign` on an issue:\n- If the issue is `help wanted` + `good first issue` + unassigned + contributor is under the limit: assign them and post a confirmation\n- If the issue is `help wanted` + `good first issue` + unassigned + contributor is at the limit: decline with a message listing their current assignments and recently dropped issues with remaining cooldown days\n- If the issue is `help wanted` + NOT `good first issue`: decline explaining that only `good first issue` issues support self-assignment\n- If the issue is `help wanted` + assigned to someone else: existing `BOT_MESSAGE_ALREADY_ASSIGNED` behavior\n- If the issue is NOT `help wanted`: existing `BOT_MESSAGE_ISSUE_NOT_OPEN` behavior\n\n**3. Keyword-based assignment requests on `good first issue` issues**\n\nWhen existing keyword detection (\"can I work on this\", etc.) triggers on a `good first issue` issue, the bot reply includes guidance about the `/assign` command so the contributor can follow up with it.\n\n**4. Cross-repo limit checking**\n\nTo enforce the 2-issue limit, query assigned issues across all community repos (kolibri, studio, kolibri-design-system, le-utils, .github, ricecooker). For the 7-day cooldown, query issue timeline events for recent unassignment events.\n\n**5. Slack notifications to `#support-dev-notifications`**\n\nThree new notification categories:\n- Assignment requested (contributor commented `/assign`)\n- Assignment approved (bot assigned the contributor)\n- Assignment rejected (at limit or ineligible)\n\nSelf-assignment activity does not trigger `#support-dev` notifications.\n\n### How to Get There\n\nManual testing in the [test-actions](https://github.com/learningequality/test-actions) repo. To test against this branch, temporarily update the reusable workflow references in test-actions to point to the feature branch instead of `main`.\n\nNote: this requires write permissions to test-actions, so manual testing may be reserved for reviewers.\n\n- To trigger `/assign` handling: comment `/assign` on an issue labeled `help wanted` + `good first issue`\n- To trigger the guidance comment: add the `good first issue` label to an issue\n- To trigger keyword detection on `good first issue`: comment with assignment-request keywords (e.g. \"can I work on this\")\n- To test the limit: assign a test contributor to 2 issues across community repos, then attempt `/assign` on a third\n- To test the cooldown: unassign a test contributor from an issue, then attempt `/assign` within 7 days\n\n### Out of Scope\n\n- Self-assignment on `help wanted` issues that are not also `good first issue` (future consideration — could be enabled after observing contributor progression)\n- Changes to issue headers — guidance is delivered via bot comments, not header modifications\n- A custom `/unassign` command — contributors can unassign themselves via the GitHub UI\n\n### Acceptance Criteria\n\n#### Guidance comment on `good first issue` labeling\n- [ ] When the `good first issue` label is applied to an issue, the bot posts a guidance comment explaining the `/assign` command, the 2-issue limit, the 7-day cooldown, the need to link PRs to assigned issues, and a link to the contributing guidelines\n- [ ] If a previous guidance comment from the bot already exists on the issue, it is deleted before posting the new one\n\n#### `/assign` command handling\n- [ ] Commenting `/assign` on an unassigned `help wanted` + `good first issue` issue assigns the commenter and posts a confirmation message\n- [ ] Commenting `/assign` on an unassigned `help wanted` + `good first issue` issue when the contributor has 2+ assigned issues (across all community repos) or recently dropped issues within the 7-day cooldown is declined with a message listing both current assignments and recently dropped issues with remaining cooldown days\n- [ ] Commenting `/assign` on a `help wanted` issue that is NOT `good first issue` is declined with a message explaining that only `good first issue` issues support self-assignment\n- [ ] Commenting `/assign` on an already-assigned `help wanted` issue triggers the existing `BOT_MESSAGE_ALREADY_ASSIGNED` behavior\n- [ ] Commenting `/assign` on a non-`help wanted` issue triggers the existing `BOT_MESSAGE_ISSUE_NOT_OPEN` behavior\n- [ ] `/assign` comments from core team members are ignored (this should be already handled by the fact that `contributor-issue-comment` runs the script only for external contributors)\n\n#### Keyword-based assignment requests\n- [ ] Existing keyword detection on `good first issue` issues includes guidance about the `/assign` command in the bot reply\n- [ ] Existing keyword detection behavior on non-`good first issue` issues is unchanged\n\n#### Slack notifications\n- [ ] Assignment requested, approved, and rejected events are sent to `#support-dev-notifications`\n- [ ] Self-assignment activity does not trigger `#support-dev` notifications\n- [ ] Existing Slack notification behavior for non-`/assign` comments is unchanged\n\n#### Documentation\n- [ ] `docs/community-automations.md` is updated with the new `/assign` behavior and decision matrix\n\n### References\n\n- #47 — Original proposal and discussion\n- [test-actions repo](https://github.com/learningequality/test-actions) — Manual testing environment\n- [Contributing guidelines](https://learningequality.org/contributing-to-our-open-code-base/) — Linked from bot messages\n\n## AI usage\n\nThis issue was drafted iteratively with Claude Code, section by section. Claude explored the existing codebase (contributor-issue-comment.js, constants.js, manage-issue-header.js, workflows, and docs) to understand the current automation architecture, then drafted each section based on my input. I reviewed and edited each section before moving to the next. The acceptance criteria reflect decisions made in the #47 discussion between myself and MisRob — Claude synthesized those into structured criteria which I verified for accuracy and completeness.","author":{"url":"https://github.com/rtibbles","@type":"Person","name":"rtibbles"},"datePublished":"2026-03-17T17:08:51Z","url":"https://github.com/learningequality/.github/issues/62"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:c0ec0887-f836-0474-dc66-be10114a6f83 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | B2E0:7B498:102F98D:15046C5:6AFFF79F |
| html-safe-nonce | 330bb53e97f73b50a6a9defca6a532bb94f964f28bfd34fa34b97025e2dcd414 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCMkUwOjdCNDk4OjEwMkY5OEQ6MTUwNDZDNTo2QUZGRjc5RiIsInZpc2l0b3JfaWQiOiI1MjM1NDk2MDYzOTU1MTA1Njk1IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | f49b84c751a0bc181c1347fede64e030966836e33ec6db19d86b1a30e16431a5 |
| hovercard-subject-tag | issue:4089927509 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/learningequality/.github/62/issue_layout |
| twitter:image | https://opengraph.githubassets.com/3d67bcda8d0c7b3609783a69882ca769e044bf9d35caa8b4807a3e1f509d88c6/learningequality/.github/issues/62 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/3d67bcda8d0c7b3609783a69882ca769e044bf9d35caa8b4807a3e1f509d88c6/learningequality/.github/issues/62 |
| og:image:alt | ❌ This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues. Overview Implement the /assign self-assignment mech... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | rtibbles |
| hostname | github.com |
| expected-hostname | github.com |
| None | 0a0d8686a27478df474dd7415776a7a080cde8838b3cd92ea7601187572e5729 |
| turbo-cache-control | no-preview |
| go-import | github.com/learningequality/.github git https://github.com/learningequality/.github.git |
| octolytics-dimension-user_id | 3926525 |
| octolytics-dimension-user_login | learningequality |
| octolytics-dimension-repository_id | 647407699 |
| octolytics-dimension-repository_nwo | learningequality/.github |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 647407699 |
| octolytics-dimension-repository_network_root_nwo | learningequality/.github |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 16a11879678aaf97e2a42c33ee70830aa084fa37 |
| ui-target | canary-2 |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width