Skip to content

Fix PR-review bot false positives (80-char rule, enable/disable)#25237

Merged
dvdksn merged 1 commit into
docker:mainfrom
dvdksn:worktree-bot-prompt-style-fixes
Jun 3, 2026
Merged

Fix PR-review bot false positives (80-char rule, enable/disable)#25237
dvdksn merged 1 commit into
docker:mainfrom
dvdksn:worktree-bot-prompt-style-fixes

Conversation

@dvdksn
Copy link
Copy Markdown
Contributor

@dvdksn dvdksn commented Jun 2, 2026

Summary

An audit of docker-agent review comments across recent merged PRs surfaced two
recurring false positives, both traced to their source:

  • The bot's prompt (.github/workflows/pr-review.yml) instructed it to flag
    lines over 80 characters, but no such rule exists — markdownlint MD013 is
    disabled and STYLE.md never mentions it. The bot itself conceded this
    mid-review on a past PR. Removed the instruction.
  • STYLE.md's word list banned "enable" yet used it in a ✅ example, so the bot
    flagged every "enable"/"disable" as a violation. Added a note clarifying that
    "turn on/off" is for UI toggles while "enable/disable" is fine in general
    prose.

Learnings

  • The docker-agent PR reviewer is driven by the additional-prompt block in
    .github/workflows/pr-review.yml (via docker/cagent-action), plus
    STYLE.md and COMPONENTS.md loaded as prompt files. That prompt — not just
    the style guides — is the source of truth for what the bot flags, so review
    noise can be tuned there directly.

Generated by Claude Code

… enable/disable

The PR-review bot's prompt instructed it to flag lines over 80 characters,
but no such rule exists in the repo (markdownlint MD013 is disabled and
STYLE.md never mentions it). Remove that instruction from pr-review.yml.

Also clarify the STYLE.md word list so "turn on/off" applies to UI toggles
while "enable/disable" stays acceptable in general prose, matching STYLE.md's
own example. This stops the bot from flagging every "enable" as a violation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented Jun 2, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 20a3d5a
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a1eb2569d93f5000819a628
😎 Deploy Preview https://deploy-preview-25237--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/release Relates to CI or deployment ci ci updates labels Jun 2, 2026
@dvdksn dvdksn added the status/review Pull requests that are ready for review label Jun 2, 2026
@dvdksn dvdksn requested a review from a team June 2, 2026 10:37
Copy link
Copy Markdown

@docker-agent docker-agent left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟢 APPROVE

No issues found. The two changes are well-targeted and accurate:

  1. Removed fabricated 80-char rule from .github/workflows/pr-review.yml — correctly eliminates a bot instruction that had no backing rule in STYLE.md or markdownlint config.
  2. Clarified enable/disable vs turn on/turn off in STYLE.md — the new paragraph correctly scopes "turn on/off" to UI toggles and permits "enable/disable" in general prose, matching the existing ✅ example already in the doc.

@dvdksn dvdksn merged commit e80099f into docker:main Jun 3, 2026
16 of 17 checks passed
@dvdksn dvdksn deleted the worktree-bot-prompt-style-fixes branch June 3, 2026 06:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/release Relates to CI or deployment ci ci updates status/review Pull requests that are ready for review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants