docs: add CONTRIBUTING.md + partner-submission PR template#237
Open
RJK134 wants to merge 1 commit into
Open
Conversation
Establishes acceptance criteria for the three contribution categories (fixes, new content, partner submissions) and gives partner submitters a PR template (`?template=partner-submission.md`) that walks them through the criteria checklist. Currently there are ~20 partner/MCP submissions in the open-PR queue with no documented bar. The policy makes acceptance criteria explicit so the queue can be triaged consistently and so future submitters know up front what's expected (live endpoint, no bundled creds, license-compatible, scoped to FSI verticals, etc.). CONTRIBUTING.md covers: - General fixes (no preamble needed) - New skills / commands / agents (with the canonical paths and the sync-agent-skills.py workflow) - Partner submissions — the 8-row acceptance criteria table - Explicit "we don't accept" list (aspirational integrations, general-purpose tools, retail-only tooling, bundled credentials) - Review process and timing expectations The partner-submission PR template breaks the acceptance criteria into checkboxes for the submitter to confirm before requesting review. README's Contributing section now points at CONTRIBUTING.md for the full guide and partner submission process. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Establishes a public acceptance bar for the three categories of contribution this repo gets:
The first two are already broadly understood. The third has been the source of a queue of ~20 open PRs with no documented bar, no consistent triage, and no clear signal to submitters about what gets accepted vs declined.
What this PR adds
CONTRIBUTING.md— full guide, including:.github/PULL_REQUEST_TEMPLATE/partner-submission.md— partner submitters opt in via?template=partner-submission.mdon the new-PR URL. Walks the criteria as checkboxes.README.md— Contributing section now points at CONTRIBUTING.md for the full guide.Triage recommendations for the existing partner-PR queue
This PR doesn't close any partner PRs — those decisions need maintainer judgment. But for reference, here's a recommended call for each based on the new criteria (column meanings: ✅ accept after review, 🟡 needs discussion, ❌ close with reason, 🔁 needs rebase onto post-#81 layout).
MCP connectors (small surface, low-risk)
.mcp.json+ README)Partner-built plugins (full plugin, higher bar)
Pre-#81 layout (need rebase before re-review)
These submissions have legitimate content but were authored before the agent-plugins/vertical-plugins restructure. They place files at top-level (e.g.
partner-built/notplugins/partner-built/).Verification
python3 scripts/check.pyclean (OK — 80 file(s) checked, 0 issues.).claude-plugin/plugin.jsontouched)Test plan
🤖 Generated with Claude Code