[PATCH v8 0/6] add AGENTS.md and scripts for AI code review

Stephen Hemminger
2026-02-09T19:51:02Z

Add a structured reference document that enables AI code review tools
to validate DPDK contributions against project standards. This document
consolidates requirements from multiple sources into a machine-readable
format optimized for automated validation workflows.

The AGENTS.md file synthesizes guidelines from:
- DPDK Contributing Code documentation (patches.rst)
- DPDK Coding Style guidelines (coding_style.rst)
- DPDK validation scripts (check-git-log.sh, checkpatches.sh)
- Linux kernel patch submission process
- SPDX License Identifier specification
- DPDK Coccinelle scripts (cocci)
- common items spotted on mailing list review

Key sections include:
- SPDX license and copyright header requirements
- Commit message format with precise limits (60 char subject,
75 char body) and tag ordering rules
- C coding style including explicit comparison requirements
- Forbidden tokens table derived from checkpatches.sh
- API tag placement rules for experimental and internal APIs
- Patch validation checklists with severity levels

The forbidden tokens section documents restrictions on deprecated
atomics, logging functions, threading APIs, and compiler built-ins
that are checked by the existing checkpatches.sh infrastructure.

Severity levels (error/warning/info) align with the exit codes and
messaging from check-git-log.sh and checkpatches.sh to help automated
tools prioritize feedback appropriately.

References:
- https://doc.dpdk.org/guides/contributing/patches.html
- https://doc.dpdk.org/guides/contributing/coding_style.html
- devtools/check-git-log.sh
- devtools/checkpatches.sh
- devtools/cocci/

v8 - revisions to AGENTS.md to detect more bugs.
previous prompt was screening out leaks where AI wasn't sure
enough to report it.

Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>

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 | 1514 ++++++++++++++++++++++++
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, 4204 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