[PATCH v8 0/6] devtools: AI-assisted code and documentation review

Stephen Hemminger
2026-02-05T17:53:03Z

This series adds tooling for AI-assisted review of DPDK patches and
documentation. The goal is to catch common coding style violations,
commit message formatting errors, and documentation issues before
patches reach the mailing list, reducing reviewer workload on
mechanical checks.

The approach uses a structured guidelines document (AGENTS.md) that
codifies the project's existing standards from the contributor
documentation, coding style guide, and validation scripts into a
format that AI models can apply consistently. The review scripts
then submit patches or documentation against these guidelines using
any of several AI providers.

The series includes:

1. AGENTS.md - consolidated review guidelines derived from
patches.rst, coding_style.rst, check-git-log.sh,
checkpatches.sh, and the Coccinelle scripts

2. analyze-patch.py - reviews patches against AGENTS.md using
AI providers (Anthropic, OpenAI, xAI, Google), with support
for patch series splitting and LTS-specific rules

3. compare-reviews.sh - runs the same patch through multiple
providers for comparison, auto-detecting available API keys

4. review-doc.py - reviews documentation files for spelling,
grammar, and technical accuracy, with batch processing and
multiple output formats

5. Contributing guide updates documenting the new tools

6. MAINTAINERS entry for the new files

AI review is intended as a supplement to human review, not a
replacement. The tools are optional and require the contributor
to have an API key for their chosen provider.

Stephen Hemminger (6):
doc: add AGENTS.md for AI code review tools
devtools: add multi-provider AI patch review script
devtools: add compare-reviews.sh for multi-provider analysis
devtools: add multi-provider AI documentation review script
doc: add AI-assisted patch review to contributing guide
MAINTAINERS: add section for AI review tools

AGENTS.md | 1392 ++++++++++++++++++++++++
MAINTAINERS | 8 +
devtools/analyze-patch.py | 1334 +++++++++++++++++++++++
devtools/compare-reviews.sh | 192 ++++
devtools/review-doc.py | 1098 +++++++++++++++++++
doc/guides/contributing/new_driver.rst | 2 +
doc/guides/contributing/patches.rst | 56 +
7 files changed, 4082 insertions(+)
create mode 100644 AGENTS.md
create mode 100755 devtools/analyze-patch.py
create mode 100755 devtools/compare-reviews.sh
create mode 100755 devtools/review-doc.py

--
2.51.0