Skills

Code Review

Mandatory code reviews via /code-review before commits and deploys

Install

npx skills add alinaqi/maggy --skill code-review -g -a claude-code -y
Repository
alinaqi/maggy710
Category
Engineering
Updated
22d ago
License
MIT
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Mandatory code reviews via /code-review before commits and deploys

Code Review Skill

Purpose: Enforce automated code reviews as a mandatory guardrail before every commit and deployment. Choose between Claude, OpenAI Codex, Google Gemini, or multiple engines for comprehensive analysis.

Sub-skills:


Pre-Review: ADR Gate (Mandatory)

Before any review engine runs, the ADR gate executes automatically:

  1. Classify, trivial changes (typos, deps, tests-only) skip the gate
  2. Discover, scan docs/adr/, _project_specs/, iCPG ReasonNodes, git history for linked ADRs and specs
  3. Enforce, if no ADRs found for non-trivial changes:
    • Interactive (default): draft ADR from git history, ask user to confirm
    • Unattended (CI): write as Status: proposed, proceed
    • Strict: block review until ADR exists
  4. Inject, feed discovered ADRs + specs into the review prompt as architectural context

ADR Compliance Review Dimension

Added to the standard 7 review categories:

CategoryWhat It Checks
ADR ComplianceChange conforms to documented decisions, no undocumented architectural shifts
FindingSeverity
Change contradicts accepted ADRCritical
Architectural decision not in any ADRHigh
ADR exists but is outdated/staleMedium
Minor drift from ADR intentLow

See adr-gate.md for full protocol, reverse-engineering rules, and configuration.


Review Engine Choice

When running /code-review, users can choose their preferred review engine:

Read the whole SKILL.md on GitHub

More in Engineering