Skip to content

docs(agents): add PR scope and batching guidance #332

Description

@pdmack

Description

Agents opening one PR per file when multiple files share a root cause creates reviewer fatigue and clutters project history. AGENTS.md currently has no guidance on PR scope or batching.

Add a short "PR scope and batching" section explaining that changes with the same root cause belong in one PR, with a concrete example and a practical heuristic.

Definition of Done

  • AGENTS.md has a "PR scope and batching" section under the existing Pull Requests guidance
  • The guidance covers the root-cause grouping rule, an example, and a reviewer-facing heuristic

Resources

Metadata

Metadata

Assignees

No one assigned

    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