Skip to content

docs: remove no-more-than-three-PRs rule from contributor guidance - #13073

Merged
chrarnoldus merged 2 commits into
Kilo-Org:mainfrom
IamCoder18:docs/remove-three-pr-rule
Aug 12, 2026
Merged

docs: remove no-more-than-three-PRs rule from contributor guidance#13073
chrarnoldus merged 2 commits into
Kilo-Org:mainfrom
IamCoder18:docs/remove-three-pr-rule

Conversation

@IamCoder18

@IamCoder18 IamCoder18 commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Issue

Closes #13072

Context

Removes the explicit "no more than three PRs at a time" cap introduced in #10574 across CONTRIBUTING.md and the contributing docs pages, while keeping the surrounding advice to prioritize high-impact work and avoid batches of low-value or weakly reviewed PRs.

Kilo is an open source project where PRs regularly take 2 weeks to a month to be reviewed and merged. Maintainer @emilieschario acknowledged this directly in #12239 (comment):

"We have limited engineering bandwidth and are always prioritizing across many priorities"

A hard cap on concurrent PRs might harm the project under those conditions. Contributor @shssoichiro agreed that PRs take a while to get merged in #12447 (comment):

"Unfortunately I am done contributing. The team doesn't care enough to review contributions in a timely manner. I'm tired of spending more time fixing merge conflicts on PRs that stay open for months than actually making meaningful improvements."

A rule that only counts PRs against a contributor while the project's review backlog grows does not deter low-value work, it deters contributors. Removing the numeric limit lets contributors build at "Kilo Speed" (https://kilo.ai/manifesto) instead of throttling themselves to match the maintainers' review cadence. The remaining text in each section still preserves the substantive guidance against low-signal batch PRs and weakly reviewed agent-generated work, which is the actual underlying concern.

Implementation

Three single-line edits that delete the numeric cap sentence. No restructuring, no other wording changes — the surrounding paragraphs already convey the desired behavior. Affected sections:

  • CONTRIBUTING.md### Tracker Use and Automation
  • packages/kilo-docs/pages/contributing/development-environment.md### Using AI and Coding Agents
  • packages/kilo-docs/pages/contributing/index.md## Tracker Use and Automation

Screenshots / Video

N/A

How to Test

Manual/local verification

  • Ran git diff main on this branch and confirmed the only changes are deletion of the "no more than three PRs at a time" wording in each of the three files above.
  • Verified the remaining surrounding guidance (prioritize high-impact work, maintainers may close batches of low-value or duplicative PRs) is intact in all three locations.

Reviewer test steps

  1. Open CONTRIBUTING.md around the ### Tracker Use and Automation section and confirm the sentence "As a rule, open no more than three PRs at a time..." is gone, and the "Prioritize high-impact or high-priority issues first..." sentence remains.
  2. Open packages/kilo-docs/pages/contributing/development-environment.md under ### Using AI and Coding Agents and confirm "Keep concurrent PRs limited, generally no more than three at a time..." is gone.
  3. Open packages/kilo-docs/pages/contributing/index.md under ## Tracker Use and Automation and confirm "As a rule, open no more than three PRs at a time..." is gone.

Checklist

  • Issue linked above, or exception explained
  • Tests/verification described
  • Screenshots/video included for visual changes, or marked N/A
  • Changeset considered for user-facing changes — N/A (internal contributor docs; no user-facing behavior change)
  • I personally reviewed the diff and can explain the changes, including any AI-assisted work.

Get in Touch

Discord: @IamCoder18

Removes the explicit numeric cap on concurrent PRs across CONTRIBUTING.md
and the contributing docs pages, while keeping guidance to prioritize
high-impact work and discourage batches of low-value or weakly reviewed PRs.
@vercel

vercel Bot commented Aug 11, 2026

Copy link
Copy Markdown

@IamCoder18 is attempting to deploy a commit to the Kilo Code Team on Vercel.

A member of the Team first needs to authorize it.

@kilo-code-bot

kilo-code-bot Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (3 files)
  • CONTRIBUTING.md
  • packages/kilo-docs/pages/contributing/development-environment.md
  • packages/kilo-docs/pages/contributing/index.md

Docs-only change removing the "no more than three PRs at a time" cap from contributor guidance. Verified: remaining text is grammatically coherent in all three locations, the surrounding guidance on prioritization and batch PRs is intact, and a repo-wide search confirms no other references to the removed rule remain. Changeset exemption is reasonable for internal contributor docs.


Reviewed by kimi-k3 · Input: 32.2K · Output: 4.5K · Cached: 198.3K

Review guidance: REVIEW.md from base branch main

@IamCoder18

Copy link
Copy Markdown
Contributor Author

Another reason to remove the limit is because the limit encourages unreviewable mega PRs instead of stacked, small PRs.

@IamCoder18

Copy link
Copy Markdown
Contributor Author

And I'll admit I've been in near-constant violation of this rule, sometimes egregiously (like right now with 11 PRs scattered over multiple weeks):

image

@vercel

vercel Bot commented Aug 12, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs (docs-staging) Ready Ready Preview Aug 12, 2026 7:22am

Request Review

@chrarnoldus
chrarnoldus merged commit ef0686e into Kilo-Org:main Aug 12, 2026
31 checks passed
t7tran pushed a commit to t7tran/kilocode that referenced this pull request Aug 14, 2026
…r-rule

docs: remove no-more-than-three-PRs rule from contributor guidance
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Remove "no more than three PRs at a time" rule from contributor guidance

2 participants