| name | code-review |
| description | Use when retrieving or addressing PR review comments. |
Code Review Workflow
Quick Start
make pr-comments
make pr-comments PR=123
make pr-comments FORMAT=json
make pr-comments FORMAT=markdown
Resolve comments in priority order, then verify with formatting, focused tests,
and the full lint gate.
Comment Categories
| Type | Response |
|---|
| Committable suggestion | Apply if correct, then verify |
| Bug or regression | Reproduce and add or update a focused test |
| Architecture concern | Use code-organization or complexity-management |
| Test gap | Add coverage at the smallest meaningful level |
| Question | Answer directly or make the code clearer |
Verification
make format
make lint
Add focused suites when comments touch behavior:
make test-unit-client
make test-e2e
make test-visual
Rules
- Do not apply suggestions blindly; check the surrounding code first.
- Do not lower lint, TypeScript, test, or metrics thresholds to pass review.
- Keep commits grouped by coherent review concern when possible.
- Re-run
make pr-comments before finishing review work.
Related Guides
Before applying this skill, confirm the active task against
../AI-AGENT-GUIDE.md and
../SKILL-DECISION-GUIDE.md so every relevant
skill is consulted.
Line Length Disclosure
Before presenting changes, check changed text files for lines longer than 100 characters.
If any exist, tell the user each path:line and measured character count.
Treat this as disclosure, not failure, unless a project gate fails.
Supporting Files