Configure with .angada.yml
Set repository or organization defaults for AI Review with Angada's YAML policy file.
Use .angada.yml to set review behavior for a repository or GitHub organization. The file uses schema version 1; the options below are the ones the current reviewer consumes. The parser and export can include other schema fields that do not currently change a review.
version: 1
reviews:
min_severity: high
skip_drafts: true
custom_instructions: "Check authorization boundaries and error handling."
ignore:
paths:
- "generated/**"
noise:
max_comments_per_pr: 8Choose where the file applies
- For one repository, commit
.angada.ymlat the repository root. Angada reads it from the pull request's head revision. - For an organization, commit
.angada.ymlin the organization's.githubrepository:<org>/.github/.angada.yml. Angada reads it from that repository's default branch.
The repository file takes precedence over the organization file, which takes precedence over workspace settings and built-in defaults, for each setting it provides. A missing or invalid value falls through to the next configured source. Workspace admins can lock repository overrides for minimum severity, draft handling, and auto-approval. A locked repository-file value is refused; the next available source or default supplies the setting.
Consumed options
| Option | Default | Meaning |
|---|---|---|
reviews.min_severity | High | Lowest finding severity posted inline. |
reviews.skip_drafts | true | Skip draft pull requests. |
reviews.custom_instructions | No repository instruction | Add review guidance. Workspace instructions remain available in Review settings. |
reviews.ignore.paths | No path patterns | Skip a review when changed paths match a glob. |
reviews.ignore.head_branches | No branch patterns | Skip when the pull request's head branch matches a glob. |
reviews.ignore.base_branches | No branch patterns | Skip when the pull request's base branch matches a glob. |
reviews.ignore.labels | No labels | Skip when a pull request has a matching label. |
reviews.ignore.titles | No title patterns | Skip when the pull request title matches a glob. |
reviews.ignore.authors | dependabot*, renovate*, *[bot] | Skip pull requests whose author matches a pattern. |
reviews.noise.max_comments_per_pr | No per-review comment cap | Limit inline comments published on one pull request. |
For additional repository guidance, see Custom context. To export the current workspace settings, open Settings → Review and choose Copy config or Download .angada.yml. The export contains workspace settings and built-in defaults; it does not merge values from repository or organization policy files.
Diagnostics and fallback
Angada reports policy-file parse and schema errors on the review check with the file path, line, severity, and message. A value that fails parsing is not applied; other valid values can still take effect, and unresolved settings fall through to the next source or default. Refused locked values are also reported with the attempted key and value.