> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Review Guidelines

> Configure custom guidelines to help Augment Code Review focus on specific areas and domain knowledge. Learn which files are automatically skipped and how to customize file exclusions.

## Tell Augment Code Review to check specific areas with guidelines

Some domain knowledge cannot be inferred from code alone. Tell Augment Code Review exactly what to check by adding custom guidelines.

### Using AGENTS.md and CLAUDE.md

If your repository already contains `AGENTS.md` or `CLAUDE.md` files, Augment Code Review automatically discovers and applies them. Rules from these files are included alongside any other guidelines you configure, so you don't need to duplicate content across formats. This is the recommended way to define guidelines for Augment Code Review, as it keeps your rules in one place and works across all Augment products.

### Adding code-review specific guidelines

For more granular control over code review, you can define additional guidelines in a YAML file. This format supports structured severity levels, glob-scoped areas, and per-guideline analytics — features not available in markdown rule files.

`<repo-root>/.augment/code_review_guidelines.yaml`

Scope guidelines to the appropriate sub-directories and focus on objective issues that can cause bugs, expose vulnerabilities, etc. and less on stylistic or subjective things.

### Example Augment Code Review Guidelines

For a complete working example, see the [Code Review Best Practices](https://github.com/augmentcode/code-review-best-practices) repository.

```yaml theme={null}
# Guidelines exclusive to augmentcode/auggie

areas:
  databases:
    description: "Data and Database related rules"
    globs:
      - "**"
    rules:
      - id: "no_pii_in_bigquery"
        description: "Never store PII data in BigQuery tables."
        severity: "high"
      - id: "no_guid_keys"
        description: "GUID foreign keys can slow lookups"
        severity: "medium"

  memory_safety:
    description: "Ensure Memory Safety"
    globs:
      - "kernel/**"
    rules:
      - id: "avoid_unsafe_rust"
        description: "Avoid unsafe Rust operations."
        severity: "high"
```

<Note>
  Common **globs** or pattern matching syntax:

  * `**` - Matches any number of directories (recursive wildcard)
    * Example: `**/test.py` matches `test.py`, `src/test.py`, `src/utils/test.py`, etc.
  * `*` - Matches any sequence of characters within a single directory level
    * Example: `*.py` matches `file.py`, `main.py` but not `src/main.py`
  * `?` - Matches exactly one character
    * Example: `test?.py` matches `test1.py`, `testA.py` but not `test10.py`
</Note>

* **Rules:** Areas can contain more than one rule. Each rule contains:
  * **ID**: Double quoted unique identifier
  * **Description**: Double quoted message summarizing intent of the rule
  * **Severity**: Expects double quoted "high", "medium" or "low". Sets the priority of review by Augment Code Review

## Files Automatically Skipped During Review

Augment Code Review automatically skips certain file types that are not typically code files. This helps focus the review on meaningful code changes and avoids wasting time on binary files, generated content, and other non-reviewable assets.

<Accordion title="File Extensions Automatically Ignored">
  The following file extensions are automatically skipped during code review:

  **Archive files:**

  * `.bz2`, `.gz`, `.xz`, `.zip`, `.7z`, `.rar`, `.zst`, `.tar`, `.jar`, `.war`, `.nar`

  **Image files:**

  * `.ico`, `.svg`, `.jpeg`, `.jpg`, `.png`, `.gif`, `.bmp`, `.tiff`, `.webm`

  **Font files:**

  * `.ttf`, `.otf`, `.woff`, `.woff2`, `.eot`

  **Document files:**

  * `.pdf`, `.doc`, `.docx`, `.xls`, `.xlsx`, `.ppt`, `.pptx`

  **Data files:**

  * `.csv`, `.tsv`, `.dat`, `.db`, `.parquet`

  **System files:**

  * `.DS_Store`, `.tags`

  **Cscope files:**

  * `.cscope.files`, `.cscope.out`, `.cscope.in.out`, `.cscope.po.out`

  **Log and output files:**

  * `.log`, `.map`, `.out`, `.sum`, `.work`, `.md5sum`

  **3D and graphics files:**

  * `.tga`, `.dds`, `.psd`, `.fbx`, `.obj`, `.blend`, `.dae`, `.gltf`

  **Shader files:**

  * `.hlsl`, `.glsl`

  **Game engine files:**

  * `.unity`, `.umap`, `.prefab`, `.mat`, `.shader`, `.shadergraph`, `.sav`, `.scene`, `.asset`

  **Python compiled files:**

  * `.pyc`, `.pyd`, `.pyo`, `.pkl`, `.pickle`

  **Protocol buffer files:**

  * `.pb.go`, `.pb.gw.go`

  **Terraform files:**

  * `.tfstate`, `.tfstate.backup`

  **Minified files:**

  * `.min.js`, `.min.js.map`, `.min.css`

  **Lock and dependency files:**

  * `.lock`, `.lockb`, `.lockfile`

  **Debug and trace files:**

  * `.trace`, `.dump`

  **Backup files:**

  * `.bak`, `.backup`

  **Database files:**

  * `.sql.gz`
</Accordion>

<Accordion title="File Patterns Automatically Ignored">
  In addition to specific extensions, the following file patterns are also skipped:

  * `*lock.json`, `*lock.yaml`, `*lock.yml` - Lock files with specific patterns
  * `go.sum` - Go module checksum files
  * `*.bundle.js`, `*.chunk.js` - JavaScript bundle files
  * `**/generated/**`, `**/*.generated.*` - Generated files
  * `*_snapshot.json` - Snapshot files
</Accordion>

## Customizing Files to Skip

You can add additional files or paths to skip during code review by specifying them in your custom guidelines file. This is useful for repository-specific generated files, large data files, or other content that shouldn't be reviewed.

### Adding Custom File Paths to Ignore

Use the `file_paths_to_ignore` section in your `code_review_guidelines.yaml` file. This field supports doublestar glob patterns for flexible matching.

```yaml theme={null}
# File paths to ignore during code review (supports doublestar glob patterns)
file_paths_to_ignore:
  - "services/code_review/**/category_taxonomy.json"
  - "**/generated/**"
  - "**/*.generated.ts"
  - "dist/**"
  - "build/**"
```

<Accordion title="Complete Example with Custom Ignores">
  ```yaml theme={null}
  # Guidelines for myproject

  # Custom files to skip during review
  file_paths_to_ignore:
    - "services/code_review/**/category_taxonomy.json"
    - "**/*.generated.graphql"
    - "public/assets/**"

  areas:
    databases:
      description: "Data and Database related rules"
      globs:
        - "**"
      rules:
        - id: "no_pii_in_bigquery"
          description: "Never store PII data in BigQuery tables."
          severity: "high"
  ```
</Accordion>