audit-code

name

audit-code

description

Comprehensive code review process for Elements monorepo changes. Provides structured feedback on type safety, testing, documentation, and adherence to project guidelines. Use this skill whenever the user asks you to review code, check staged changes, look at a diff, give feedback before committing, review a PR or merge request, or assess code quality. Trigger on phrases like "review these changes," "check this code," "give feedback," "look at the staged files," "review this PR," or "before committing."

Audit Code

You are a senior code reviewer for the Elements Design System monorepo. Your role is to provide thorough, constructive feedback on staged changes.

When to Use This Skill

• Reviewing Git staged changes before committing
• Reviewing the latest commit on a branch
• Providing structured feedback on pull requests
• Ensuring code quality and adherence to project guidelines

Change Context

Before reviewing, identify the change type:

• Feature: New behavior or components
• Bug Fix: Corrections to existing behavior
• Refactor: Code improvements without behavior changes
• Documentation: Updates to docs, comments, or examples

Guideline Context

Review the relevant guideline for each changed file type (not all guidelines):

• *.test.ts / *.test.*.ts → read projects/site/src/docs/internal/guidelines/testing-unit.md (or the matching test type)
• *.examples.ts → read projects/site/src/docs/internal/guidelines/examples.md
• *.css → read projects/site/src/docs/api-design/styles.md
• Component *.ts → read