Reviews
reviews/ defines project checks for code-review bots, such as dependency boundaries, error handling, and migration risks. One review spec writes that guidance into each bot's own file:
| Target | Reads |
|---|---|
| Cursor (Bugbot) | .cursor/BUGBOT.md, and <scope>/.cursor/BUGBOT.md for scoped specs |
| Codex (code review) | a ## Code Review Rules section of the root or scoped AGENTS.md |
Goose (goose review) | .agents/REVIEW.md, and <scope>/.agents/REVIEW.md for scoped specs |
| Ellipsis (code review) | one reviewer's prompt in .ellipsis/code-review.yaml; scoped specs become sections that apply only to changes in their directory |
Other tools report review specs as unsupported.
Ellipsis takes the reviewer, its model, and any posting rules from x-ellipsis in a settings spec. Without a reviewer, sync writes no file and says what is missing.
Write one
agnostic-ai new review code-quality
It creates .agnostic-ai/reviews/code-quality.md. Write the checks the bot should apply, then sync and start a review. The spec supplies guidance only; it does not install or start a bot.
---
scope: backend
---
Flag any handler that talks to the database directly instead of going through a repository.
Reviews follow scope and the folder layout like rules. Specs with the same scope are joined into one file, without frontmatter. The Codex section sits in AGENTS.md, so every tool that reads AGENTS.md loads it, unless a targets: filter leaves out codex.
Include a file
Use a line containing only @path to include a project file. Paths start at the project root. For example, a folder's README.md can supply its review guidance:
---
scope: services/billing
target: cursor
---
@services/billing/README.md
- Sync writes the file's text in place of the line, so a README change shows up in
sync --check. - A missing file, an absolute path, or a path outside the project fails the load (AAI-001).
- A line inside a fenced code block stays as written.
- An included file is not searched for more
@pathlines. - Only reviews take
@pathlines. OnAGNOSTIC_AI.mdtheresolve-importssetting controls them.