Documentation-based proposal; not a hands-on test
Make the proposed change reviewable
Start with the problem, expected behavior, and files intentionally changed. Remove unrelated formatting and generated noise. GitHub's review guidance says small, focused pull requests are easier to understand, safer to merge, and better at preserving useful history. That matters more when code was generated quickly: a large patch can hide accidental scope even if every line looks plausible.
Ask for a short change note: why this approach, what assumptions it makes, what was tested, and where the reviewer should focus. If the assistant produced a summary, verify it against the diff. Do not accept a summary as a substitute for reading the changed files.
Review in a risk-first order
- Scope: compare the requested change with every modified file.
- Behavior: trace main paths, error paths, and boundary inputs.
- Tests: run existing relevant tests and add a regression check for the bug or requirement.
- Secrets and permissions: inspect logs, config, fixtures, workflow files, and new access.
- Dependencies: inspect manifest and lock-file changes, versions, purpose, and security signals.
- Maintenance: check naming, duplication, comments, and fit with local conventions.
GitHub advises reviewers to inspect files individually and use dependency review for manifest or lock-file changes, while still reading the source diff because automated dependency views may not parse everything. Its secret guidance recommends minimum credential permissions and warns that log redaction is not guaranteed for every transformed secret. In practice, search the diff for tokens, private URLs, copied production data, and permissive workflow settings even if secret scanning is enabled.
Require evidence matched to the change
| Change | Minimum evidence |
|---|---|
| Bug fix | A failing-before, passing-after regression test or a reproducible check |
| Refactor | Existing behavior tests plus a narrow explanation of structural change |
| Dependency update | Lock-file review, release notes where relevant, build and tests |
| Permission or workflow change | Least-privilege review and safe test context |
| Generated data/query logic | Control totals and representative record checks |
Passing tests do not prove the requirement is correct, but failing or absent tests remove an important signal. Review the test itself: an assistant can write a test that merely restates its implementation or misses the original failure.
Keep speed claims outside the merge decision
A fast first draft may still create review and repair work. The merge decision should use correctness, risk, readability, and evidence. If the team wants to study productivity, measure the whole task separately with the workflow pilot scorecard. The existing coding-study note explains why one measured context should not become a universal claim.
Use the review result to improve the process: recurring unnecessary files suggest tighter prompts or smaller assignments; missing tests suggest a better acceptance template; repeated dependency surprises suggest stronger automated checks. Do not turn one accepted patch into proof that the tool is broadly productive.
Leave a clean record
The final review should say what was checked, which tests ran, what remains uncertain, and who accepted the risk. If the patch changes generated artifacts, deployment files, or data migrations, call those out. Reject or split changes whose scope cannot be reviewed confidently. The goal is not to prove that a person or model wrote good code. It is to make one proposed change understandable enough to accept, revise, or decline.
Before you hand it over
Use this as a working check, not certification. Checks stay in this page only and reset on reload.
0 of 5 checked
Sources & verification
Product details are based on the linked documentation. The proposed workflow and worked examples are editorial guidance, not measured test results.
- Helping others review your changesSource date: not stated · Retrieved: 2026-09-19T19:39:00Z
Small focused pull requests, clear context, self-review, relevant tests, and security-focused review.
- Reviewing dependency changes in a pull requestSource date: not stated · Retrieved: 2026-09-19T19:39:00Z
Review of added, removed, or updated dependencies, vulnerabilities, versions, licenses, and limitations of automated parsing.
- SecretsSource date: not stated · Retrieved: 2026-09-19T19:39:00Z
Least-privilege credentials, controlled secret access, and limitations of automatic log redaction.
Continue the workflow
- Reconcile a spreadsheet before writing the story around it
Check an imported or transformed spreadsheet before using its figures in analysis or client work.
- Validate the SQL answer before trusting the sentence
Review an analytical SQL query safely before using its output in a report or decision.
- What the developer slowdown study actually measured
A surprising result matters most when its task and participants stay attached.
- A revised experiment is not a retraction
METR's follow-up changed the study design while preserving the earlier finding.