Skip to content

Tell contributors to search open PRs before writing a fix - #9095

Open
rdoupe wants to merge 1 commit into
omacom:quattrofrom
rdoupe:docs/agents-md-check-open-prs
Open

Tell contributors to search open PRs before writing a fix#9095
rdoupe wants to merge 1 commit into
omacom:quattrofrom
rdoupe:docs/agents-md-check-open-prs

Conversation

@rdoupe

@rdoupe rdoupe commented Aug 30, 2026

Copy link
Copy Markdown

Problem

AGENTS.md is where upstream work lands — contributing.md already calls it "the authority on contributions", and #6718 makes the handoff explicit ("for upstream source work, clone and follow its AGENTS.md"). It says nothing about checking whether a fix already exists.

The result: the lock screen losing password focus after suspend has four open PRs (#7164, #7592, #8560, #8869). I opened a fifth (#9089, now closed) before finding them. Four people fixed the same twenty lines and a maintainer has to compare all of them.

Why here and not contributing.md

#8609 and #6959 add duplicate-check guidance to default/agents/skills/omarchy/contributing.md. Two problems with that location:

  • It lives inside the omarchy skill, whose description says it excludes source development. An agent asked to write a fix correctly decides the skill doesn't apply and never loads the file — that is exactly what happened in my session, with the skill installed.
  • Refine the Omarchy agent skill for installed systems #6718 deletes contributing.md outright.

AGENTS.md is loaded by anyone working in the checkout, survives #6718, and is the file #6718 routes contributors to. #6959's bug.yml checkbox remains the right control for the issue path; this covers the PR path.

Change

A # Pull Requests section after # Git: search before writing, search twice with different wording, and when an open PR covers the change, add to it — confirm the bug, review the approach, contribute a missing test — instead of opening a competing one. Docs only, +13/−0, full lines per the file's own Style section.

AGENTS.md is the file upstream work is routed to, and it said nothing
about checking whether a fix already exists. The lock screen losing
password focus after suspend had four open PRs before a fifth was filed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019q6kd5nX4D8xS7jy7KJYtP
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.

1 participant