# Awesome Reviewers

Expert engineering instructions for AI and infrastructure domains, distilled from code
review discussions in production open-source repositories. Each instruction is a
self-contained set of rules you can drop into an agent, harness or context broker as-is.

5424 instructions from 246 repositories, across 12 domains. Last updated 2026-08-12.

## Developer resources

- [OpenAPI description](https://awesomereviewers.com/openapi.json) (application/vnd.oai.openapi+json;version=3.1) — OpenAPI 3.1 description of every endpoint listed here.
- [API documentation](https://awesomereviewers.com/api/) (text/html) — Human-readable reference for the endpoints, error format and markdown variants.
- [Site overview](https://awesomereviewers.com/raw/site.md) (text/markdown) — The homepage as markdown: what this is, the endpoints, the domains.
- [Corpus index](https://awesomereviewers.com/raw/index.json) (application/json) — Every instruction: slug, title, description, domain, topic, language, source, updated, raw URL.
- [Single instruction](https://awesomereviewers.com/raw/<slug>.md) (text/markdown) — One instruction as plain markdown, with a commented header carrying its metadata.
- [Domain bundle](https://awesomereviewers.com/raw/bundles/<domain>.md) (text/markdown) — Every instruction in one domain, concatenated into a single markdown file.
- [Source discussions](https://awesomereviewers.com/<slug>.json) (application/json) — The review discussions one instruction was derived from.
- [Search index](https://awesomereviewers.com/assets/data/search.json) (application/json) — Column-oriented index used by the search box: smaller, truncated descriptions.
- [LLM index](https://awesomereviewers.com/llms.txt) (text/plain) — Domain-grouped listing of the whole corpus with raw URLs.
- [Sitemap](https://awesomereviewers.com/sitemap.xml) (application/xml) — Every HTML page on the site.

## Domains

| Domain | Instructions | Updated | Bundle |
| --- | --- | --- | --- |
| AI Agents & Assistants | 838 | 2026-08-11 | [ai-agents.md](https://awesomereviewers.com/raw/bundles/ai-agents.md) |
| LLM Serving & Gateways | 335 | 2026-07-29 | [llm-infra.md](https://awesomereviewers.com/raw/bundles/llm-infra.md) |
| ML Frameworks & Platforms | 343 | 2026-04-28 | [ml-systems.md](https://awesomereviewers.com/raw/bundles/ml-systems.md) |
| Containers & Orchestration | 279 | 2026-08-09 | [orchestration.md](https://awesomereviewers.com/raw/bundles/orchestration.md) |
| Cloud, IaC & Networking | 435 | 2026-08-05 | [cloud-infra.md](https://awesomereviewers.com/raw/bundles/cloud-infra.md) |
| Databases & Data Platforms | 432 | 2026-07-26 | [data-systems.md](https://awesomereviewers.com/raw/bundles/data-systems.md) |
| Observability & Telemetry | 204 | 2025-09-03 | [observability.md](https://awesomereviewers.com/raw/bundles/observability.md) |
| Security & Access Control | 225 | 2026-08-09 | [security.md](https://awesomereviewers.com/raw/bundles/security.md) |
| Language Runtimes & Compilers | 406 | 2025-10-23 | [runtimes.md](https://awesomereviewers.com/raw/bundles/runtimes.md) |
| Developer Tooling | 685 | 2026-05-08 | [devtools.md](https://awesomereviewers.com/raw/bundles/devtools.md) |
| Application Frameworks & UI | 1179 | 2026-08-12 | [app-frameworks.md](https://awesomereviewers.com/raw/bundles/app-frameworks.md) |
| Documentation & Knowledge | 63 | 2026-07-22 | [docs.md](https://awesomereviewers.com/raw/bundles/docs.md) |

## Errors

RFC 9457 problem details, documented at https://awesomereviewers.com/api/#errors.

- `not_found` (404) — Every published path is listed in https://awesomereviewers.com/raw/index.json and https://awesomereviewers.com/llms.txt. Look the slug up there and retry.
- `not_acceptable` (406) — Send Accept: text/markdown for markdown, text/html for the rendered page, application/json for the JSON endpoints, or */* to take whatever is served.

Apache-2.0. Source: https://github.com/baz-scm/awesome-reviewers
