diff --git a/.github/workflows/add-to-project.yml b/.github/workflows/add-to-project.yml new file mode 100644 index 0000000..b8947a8 --- /dev/null +++ b/.github/workflows/add-to-project.yml @@ -0,0 +1,22 @@ +name: Add to Operations board + +on: + issues: + types: [opened, reopened] + +# No GITHUB_TOKEN needed — the add-to-project step authenticates with the +# ADD_TO_PROJECT_PAT org secret. +permissions: {} + +jobs: + add-to-project: + # Only auto-add issues authored by org owners/members/collaborators — + # outsider-authored issues in public repos need human triage onto the board. + if: contains(fromJSON('["OWNER", "MEMBER", "COLLABORATOR"]'), github.event.issue.author_association) + runs-on: ubuntu-latest + timeout-minutes: 5 + steps: + - uses: actions/add-to-project@244f685bbc3b7adfa8466e08b698b5577571133e # v1.0.2 + with: + project-url: https://github.com/orgs/NextCommerceCo/projects/10 + github-token: ${{ secrets.ADD_TO_PROJECT_PAT }} diff --git a/AGENTS.md b/AGENTS.md index 5f592f6..66970cd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -38,3 +38,16 @@ Unless you are maintaining the docs site itself, skip: This repository is maintained by the NEXT team only. External pull requests are not accepted. See `README.md` and `docs/MAINTENANCE.md`. + +## Issue tracking + +Work in this repo is tracked with GitHub Issues and coordinated on the +org-level **[Operations](https://github.com/orgs/NextCommerceCo/projects/10)** +Kanban board (Todo / In Progress / Done). New issues are added to the board +automatically by the `add-to-project` workflow. + +Before starting work on an issue: check it is not assigned to someone else, +assign yourself (`gh issue edit --add-assignee @me`), and move the card to +In Progress. Open PRs with `Closes #`; when the issue closes on merge, the board's built-in "Item closed" automation moves the card to Done. +Contributors have a `/next-board` skill that wraps these board operations +(status, claim, move, create).