“Will this break?”
Check behavior and correctness.
Weave Checks reviews pull requests against your team’s standards. Write a rule in Markdown. Let the check do the reminding.
Your rules. Your repo. Every pull request.Flag comments that repeat the code. Keep the ones that explain a decision, a constraint, or a surprising detail.
Flagged: // Get the user's full nameexport function getFullName(user: User) { return `${user.first} ${user.last}`;}The function already says this. Remove the comment—it adds a line, not information.
Check behavior and correctness.
Check conventions and code quality.
Keep your bug reviewer. Add checks for the standards you’re tired of repeating.
One Markdown file. One standard worth keeping.
Explore the check library---
name: Documentation Signal
description: Keep comments worth reading
intelligence: low
---
Flag comments that only repeat the code.
Keep the why:
- Non-obvious constraints
- Decisions and trade-offs
- Context the code can’t tell youRuns in GitHub Actions. Works with Weave Router or your own Anthropic-compatible provider.
Already have checks in your repo? Run them locally, too.
Create a Router key and save it as the WEAVE_ROUTER_KEY repository secret.
Create a keyCommit the GitHub Actions workflow. Add your own Markdown files in .weave-checks, or opt into the starter checks.
Get the workflowIt’s a complement, not a replacement. Bug reviewers look for defects. Checks focuses on the other half of code review: keeping the codebase consistent with your team’s principles. Use both.
No. It posts findings on the pull request. You or your coding agent make the fix; Checks can then resolve the comment thread. The interactive example above shows that sequence, not an automatic code edit.
Checks is open source under Apache-2.0. Model usage and any applicable GitHub Actions charges are separate. Use Weave Router or an Anthropic-compatible provider; cost depends on your checks, diffs, and chosen models.
Checks and Pull requests write access for reviews, plus Contents write to resolve review threads. The agent’s tools are read-only and it does not receive the App token. The action uses a short-lived, repository-scoped token and revokes it when the job finishes. Fork pull requests are skipped.
Pick one standard you care about.
Make it your first check.