# Code Review

> Mandatory pre-commit validation for every Copilot code review on pull requests in the regle monorepo. Always verify commitlint compliance on commit titles and descriptions, pnpm workspace install, lint (vp lint), and format (vp fmt --check). Loaded on every code review — do not skip.

- Skill: `victorgarciaesgi/code-review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add victorgarciaesgi/code-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/victorgarciaesgi/code-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: victorgarciaesgi (https://skillmd.com/u/victorgarciaesgi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/victorgarciaesgi/code-review

---


# Code review — pre-commit validation

**Apply on every pull request review.** These checks are blocking. Do not approve a PR until all pass or the author has addressed failures.

## Review checklist (run every time)

| # | Gate | Command | On failure |
|---|------|---------|------------|
| 1 | Commit messages | `printf '%s' "$MSG" \| pnpm exec commitlint` per commit | Blocking comment + suggested fix |
| 2 | Workspace | `test -f node_modules/.modules.yaml` | Request `pnpm install` |
| 3 | Lint | `pnpm run lint` | Blocking; suggest `pnpm run lint:fix` |
| 4 | Format | `pnpm run fmt:check` | Blocking; suggest `pnpm run fmt` |

Run all commands from the repo root after `pnpm install`.

## Commit messages (commitlint)

Every commit must follow [Conventional Commits](https://www.conventionalcommits.org/) per `commitlint.config.ts` (`@commitlint/config-conventional`).

```
type(optional-scope): imperative subject

Optional body explaining why.
```

- Types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `ci`, `build`
- Subject: lowercase, imperative mood, no trailing period
- Blank line between title and body when a body is present

## Auto-fix loop

```bash
pnpm run lint:fix
pnpm run fmt
pnpm run lint
pnpm run fmt:check
```

## Common commitlint failures

| Error | Fix |
|-------|-----|
| `type-empty` / `subject-empty` | Use `type: subject` format |
| `type-enum` | Use an allowed conventional type |
| `subject-case` | Keep subject lowercase |
| `subject-full-stop` | Remove trailing `.` from subject |