Skip to content

fix(ci): require substantive code review comments#369

Merged
mcj-coder merged 1 commit intomainfrom
fix/291-code-review-depth
Jan 15, 2026
Merged

fix(ci): require substantive code review comments#369
mcj-coder merged 1 commit intomainfrom
fix/291-code-review-depth

Conversation

@mcj-coder
Copy link
Owner

Summary

  • Add DangerJS Rule 8 to warn on brief/empty approval reviews (<50 chars)
  • Add "For Reviewers" section to PR template with review guidance
  • Add "Code Review Guidelines" section to CONTRIBUTING.md with exemplar format

Closes #291

Test plan

🤖 Generated with Claude Code

- Add DangerJS Rule 8 to warn on brief/empty approval reviews (<50 chars)
- Add "For Reviewers" section to PR template with guidance
- Add "Code Review Guidelines" section to CONTRIBUTING.md with exemplar

Refs: #291

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@mcj-coder mcj-coder enabled auto-merge (squash) January 15, 2026 14:43
@github-actions
Copy link

Messages
📖 All PR validation checks passed.

Generated by 🚫 dangerJS against 3679f02

Copy link
Collaborator

@martincjarvis martincjarvis left a comment

Choose a reason for hiding this comment

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

QA Review - Code Review Depth Enforcement

Files reviewed: dangerfile.js, PULL_REQUEST_TEMPLATE.md, CONTRIBUTING.md

Verification

dangerfile.js (Rule 8):

  • Correctly filters for APPROVED reviews only
  • MIN_REVIEW_BODY_LENGTH of 50 chars is reasonable threshold
  • Only warns if ALL approvals are brief (allows mixed quality)
  • Clear warning message explains what's needed

PR Template:

  • "For Reviewers" section provides clear guidance
  • Example approval comment demonstrates expected format
  • Placed appropriately at bottom (doesn't interfere with author sections)

CONTRIBUTING.md:

  • Code Review Guidelines section clearly explains requirements
  • Exemplar review format is practical and achievable
  • Blockquote exemplar is realistic and demonstrates good practice

Potential Edge Cases Checked

  • Empty reviews array: Handled (guard approvedReviews.length > 0)
  • Reviews with only whitespace: Handled (body.trim().length)
  • Mixed quality reviews: Only warns if ALL are brief

Descoped Item

Confirmed: "Code review skill updated" correctly descoped since requesting-code-review is in superpowers, not this repo.

Approved - no blocking issues found.

@mcj-coder mcj-coder merged commit 75c6702 into main Jan 15, 2026
6 checks passed
@mcj-coder mcj-coder deleted the fix/291-code-review-depth branch January 15, 2026 15:49
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.

fix(process): Require line-level code review comments on PRs

2 participants