Skip to content

Conversation

@lnhsingh
Copy link
Collaborator

Implements an automated documentation review system using Claude API that:

  • Reviews only changed lines in PRs (not pre-existing content)
  • Checks grammar, spelling, style guide adherence, MDX syntax, frontmatter, code blocks, and links
  • Posts inline comments on specific lines with severity levels
  • Provides actionable suggestions for fixes
  • Learns from accepted/ignored feedback over time
  • Follows Google Developer Documentation Style Guide
  • Excludes auto-generated reference documentation

Components in this commit:

  • Python review agent script (.github/scripts/pr_review_agent.py)
  • Configuration file for customization (.github/pr-review-config.json)
  • Feedback tracking system for learning (.github/pr-review-feedback.json)
  • Comprehensive documentation (.github/PR_REVIEW_AGENT.md)

Note: The GitHub Action workflow file (.github/workflows/pr-review.yml) needs to be added manually by a repository admin due to GitHub App permissions.

Overview

Type of change

Type: [Replace with: New documentation page / Update existing documentation / Fix typo/bug/link/formatting / Remove outdated content / Other]

Related issues/PRs

  • GitHub issue:
  • Feature PR:
  • Linear issue:
  • Slack thread:

Checklist

  • I have read the contributing guidelines
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed
  • I have gotten approval from the relevant reviewers
  • (Internal team members only / optional) I have created a preview deployment using the Create Preview Branch workflow

Additional notes

Implements an automated documentation review system using Claude API that:
- Reviews only changed lines in PRs (not pre-existing content)
- Checks grammar, spelling, style guide adherence, MDX syntax, frontmatter, code blocks, and links
- Posts inline comments on specific lines with severity levels
- Provides actionable suggestions for fixes
- Learns from accepted/ignored feedback over time
- Follows Google Developer Documentation Style Guide
- Excludes auto-generated reference documentation

Components in this commit:
- Python review agent script (.github/scripts/pr_review_agent.py)
- Configuration file for customization (.github/pr-review-config.json)
- Feedback tracking system for learning (.github/pr-review-feedback.json)
- Comprehensive documentation (.github/PR_REVIEW_AGENT.md)

Note: The GitHub Action workflow file (.github/workflows/pr-review.yml) needs to be
added manually by a repository admin due to GitHub App permissions.
@github-actions github-actions bot added the python For content related to the Python version of LangChain projects label Nov 10, 2025
@github-actions
Copy link
Contributor

Mintlify preview ID generated: preview-claude-1762810956-524603a

@lnhsingh lnhsingh closed this Nov 13, 2025
@lnhsingh lnhsingh deleted the claude/add-pr-review-agent-011CUzvG8i7XZQuKtyE2RGGi branch November 13, 2025 20:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

python For content related to the Python version of LangChain projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants