Skip to content

docs: add contributor-to-core-team PR handoff process#902

Merged
tamirdresher merged 4 commits intodevfrom
diberry/contributor-handoff-docs
Apr 8, 2026
Merged

docs: add contributor-to-core-team PR handoff process#902
tamirdresher merged 4 commits intodevfrom
diberry/contributor-handoff-docs

Conversation

@diberry
Copy link
Copy Markdown
Collaborator

@diberry diberry commented Apr 7, 2026

  • Updated "Handoff: Contributor → Core Team" section in CONTRIBUTING.md
  • Rewrote checklist item to say "all required CI checks are green" with a note that the changeset/CHANGELOG gate only applies when SDK/CLI source files change

External contributors can't use "Fix with Copilot" on review comments
(requires write access). Document the explicit handoff flow:
- Contributor: CI green + undraft + accept Copilot suggestions
- Core team: address remaining Copilot issues, review, merge

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@diberry diberry added the docs label Apr 7, 2026
Copilot AI review requested due to automatic review settings April 7, 2026 15:46
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 7, 2026

🟢 Impact Analysis — PR #902

Risk tier: 🟢 LOW

📊 Summary

Metric Count
Files changed 1
Files added 0
Files modified 1
Files deleted 0
Modules touched 1

🎯 Risk Factors

  • 1 files changed (≤5 → LOW)
  • 1 module(s) touched (≤1 → LOW)

📦 Modules Affected

root (1 file)
  • CONTRIBUTING.md

This report is generated automatically for every PR. See #733 for details.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the contributor documentation to formalize a “Contributor → Core Team” handoff point for PRs, clarifying how external contributors can signal readiness when they don’t have repo write access (e.g., can’t use “Fix with Copilot”).

Changes:

  • Updates the “Pull Request Process” to start with a draft PR and explicitly call out “Ready for review” as the handoff signal.
  • Adds a new “Handoff: Contributor → Core Team” section detailing contributor/core-team responsibilities and the “Fix with Copilot” permission limitation.

Comment thread CONTRIBUTING.md Outdated
diberry and others added 2 commits April 7, 2026 09:25
External fork contributors cannot use "Commit suggestion" or "Fix with
Copilot" buttons — both require write access. Updated to say "manually
apply in your fork and push" which is the actual workflow.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Collaborator

@tamirdresher tamirdresher left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM — clear, practical handoff docs for external contributors. Good callout about Copilot suggestion buttons not working from forks.

Copy link
Copy Markdown
Collaborator

@tamirdresher tamirdresher left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Clear, practical handoff docs for external contributors. Good callout about Copilot suggestion buttons not working from forks.

@tamirdresher tamirdresher merged commit d785408 into dev Apr 8, 2026
11 checks passed
tamirdresher pushed a commit that referenced this pull request Apr 21, 2026
* docs: add contributor-to-core-team handoff process in CONTRIBUTING.md

External contributors can't use "Fix with Copilot" on review comments
(requires write access). Document the explicit handoff flow:
- Contributor: CI green + undraft + accept Copilot suggestions
- Core team: address remaining Copilot issues, review, merge

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: clarify changeset CI check is conditional on SDK/CLI source changes

Agent-Logs-Url: https://github.com/bradygaster/squad/sessions/d6374ed4-60de-4839-b33f-0ba5b311ec81

Co-authored-by: diberry <41597107+diberry@users.noreply.github.com>

* docs: fix misleading Copilot suggestion permissions claim

External fork contributors cannot use "Commit suggestion" or "Fix with
Copilot" buttons — both require write access. Updated to say "manually
apply in your fork and push" which is the actual workflow.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
@bradygaster
Copy link
Copy Markdown
Owner

Closed by #theSquadsquad triage — verified fixed in v0.9.4 (PR #919 merged).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants