Skip to content

Contributor PRs: write down the chores policy and add a /update command #464

Closed

Description

@itsskofficial

Maintainers now handle the mechanical chores on contributor pull requests (merging main, resolving conflicts, changelog file names, lint fixes, re-running checks), while anything that changes behaviour or design stays with the contributor as a review. This needs:

  1. The policy written down in CONTRIBUTING.md (what we may do on your branch, what we always do, what stays yours, and that the merge queue doesn't need an up-to-date branch), plus a line in docs/AGENT_WORKFLOW.md for agents.
  2. A /update comment command on pull requests. The PR author or anyone with write access comments exactly /update; a bot merges main into the branch with GitHub's update-branch API (a merge, never a rebase) and replies in plain words. On conflicts it lists the files, adds a needs update label and says a maintainer will resolve them. The label comes off once the branch is up to date. The bot never checks out or runs the PR's code.

Open question to test for real: whether the workflow's built-in token may update a branch in a fork. If not, the command falls back to pointing the contributor at GitHub's own "Update branch" button and labelling the PR for maintainers, with no personal tokens or new secrets.

Activity

  1. itsskofficial commented on Oct 18, 2026

    @itsskofficial
    ContributorAuthor

    Working on this in #472.

  2. added a commit that references this issue on Oct 18, 2026
    3d90360
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions