Skip to content

Allow large mechanical PRs in AGENTS.md and say how to check a change - #876

Open
lmac-1 wants to merge 1 commit into
mainfrom
agents-md-mechanical
Open

lmac-1 wants to merge 1 commit into
mainfrom
agents-md-mechanical

Conversation

@lmac-1

@lmac-1 lmac-1 commented Sep 25, 2026 •

Copy link
Copy Markdown
Collaborator

Short Description

Adds two things to AGENTS.md: an exception to the 20-file limit for mechanical changes that the build or a script checks, and a short section on how to check any change before opening a PR.

Details

The 20-file limit is there so reviewers can read each changed page. It doesn't fit mechanical changes like #874 (rewriting links) or #875 (running Prettier), where every edit follows one rule and the build catches mistakes. Splitting those only adds review rounds. The exception keeps such PRs to the mechanical change only.

The build steps were only in update-content/SKILL.md, so an agent doing one-off work outside a skill never saw them. The new section also says that broken-anchor warnings don't fail the build and that main already has some, so agents fix only the ones they add.

Text only, so no build was run for this PR.

AI Usage

Please disclose how you've used AI in this work (it's cool, we just want to know!):

  • I have used Claude Code
  • I have used another model
  • I have not used AI

You can read more details in our Responsible AI Policy

This branch has not been deployed

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

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant