From fd76eff10985e1ae839288ae05e9b6c346e36184 Mon Sep 17 00:00:00 2001
From: Evgeniy Unzhakov <unzhakov_ev@pnpi.nrcki.ru>
Date: Fri, 22 May 2026 15:18:00 +0300
Subject: [PATCH] docs: add docs_check.py to quality gates, add bs_exp CLI,
 document pytest markers

---
 AGENTS.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 33bf0bc..7bbd231 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -52,11 +52,12 @@ State which phase you're in. Name phases explicitly.
 All must pass before merge:
 
 ```bash
-pytest
-nbmake notebooks/
-black --check .
-ruff check .
-mypy .
+pytest                           # all tests (markers: property, physics, api, quality, integration, slow, requires_ensdf)
+nbmake notebooks/                # execute notebooks as tests
+black --check .                  # formatting
+ruff check .                     # linting
+mypy .                           # type checking (strict)
+python scripts/docs_check.py     # documentation consistency (version, file refs, CLI args)
 ```
 
 Run individually to identify failures.
@@ -67,6 +68,7 @@ After quality gates pass, run:
 
 ```bash
 bs_pnpi --nuclide Tc99 -vv --output ./output/verification.csv --plot ./output/verification.png --log-file ./output/debug.log 2>&1 | tee ./output/debug_stdout.log
+bs_exp --help                    # verify experimental data CLI
 ```
 
 Verify parameter consistency across all components. Save artifacts to `./output/`.