agent-quality-kit 0.6.0 → 0.7.0

package/README.md

@@ -196,7 +196,7 @@ Already using [pre-commit](https://pre-commit.com)? Three lines in the file you
 ```yaml
 repos:
   - repo: https://github.com/arsen-ask-lx/Agent_Quality_Kit
-    rev: v0.6.0
+    rev: v0.7.0
     hooks:
       - id: aqk            # runs what the repository declares; blocks below AQK-1
       # - id: aqk-doctor   # read-only: the level and what is missing, blocks nothing
@@ -217,7 +217,7 @@ layer AQK adds.
 [![on the GitHub Marketplace](https://img.shields.io/badge/GitHub%20Marketplace-Agent%20Quality%20Kit-2ea44f?logo=github)](https://github.com/marketplace/actions/agent-quality-kit-aqk)
 
 ```yaml
-- uses: arsen-ask-lx/Agent_Quality_Kit@v0.5.0
+- uses: arsen-ask-lx/Agent_Quality_Kit@v0.7.0
   with:
     min: 1   # the build fails below AQK-1, or if any declared gate failed
 ```
@@ -260,6 +260,22 @@ Every `doctor --run` rewrites `.aqk/last-run.md` — a short report of what actu
 long it took. The list of gates in the manifest says nothing about how many of them are alive
 right now; the report does. The file is ephemeral — keep it in your own `.gitignore`.
 
+### Introducing a rule into a live project
+
+Three ways, and each has a price. A big clean-up is put off forever because it is big. The
+ratchet turns existing violations into debt and blocks new ones — right once the rule is agreed.
+And while it is still being argued about, an advisory gate shows findings without failing the run:
+
+```yaml
+advisory:
+  - complexity-limit
+```
+
+Declared in the manifest, not passed as a flag. A flag that says "fail nothing" downgrades every
+check at once, is invisible in the diff, and is never named in the summary — that is
+`continue-on-error`, which this tool marks red elsewhere. The list is printed on **every** run:
+an advisory gate everyone forgot about is a switched-off check.
+
 ## When a bug slips past the guards
 
 ```bash

package/README.ru.md

@@ -304,6 +304,22 @@ Ruff, ESLint и gitleaks и так находят плохой код — AQK з
 [`agents-lint`](https://github.com/giacomo/agents-lint) делает это лучше, другую — потому что
 91 находка из 120 оказалась законным приёмом.
 
+### Как ввести правило в живой проект
+
+Три способа, и у каждого своя цена. Большая чистка откладывается навсегда, потому что она
+большая. Храповик превращает старые нарушения в долг и блокирует новые — верно, когда правило
+уже принято. А пока о правиле спорят, совещательный гейт показывает находки, не роняя прогон:
+
+```yaml
+advisory:
+  - complexity-limit
+```
+
+Объявлением в манифесте, а не флагом. Флаг «не роняй ничего» понижает все проверки разом, не
+виден в дифе и не назван в итоге — это тот самый `continue-on-error`, который мы сами красим.
+Список печатается **каждый** прогон: совещательный гейт, о котором забыли, — это выключенная
+проверка.
+
 ## Методички одним файлом
 
 ```bash

package/kit/docs/ai/agent-harness-playbook.md

@@ -193,7 +193,7 @@
 |---|---|---|---|
 | `block-dangerous-commands.sh` | PreToolUse (Bash **и** PowerShell) | exit 2 + причина в stderr на необратимое: force-push, reset --hard, `DROP DATABASE`, `TRUNCATE`, `docker volume rm`, `rm -rf /` | fail-safe: не распарсил JSON → грепай сырой ввод. Штатный сброс дев-БД (`compose down -v`) — НЕ блокировать |
 | `auto-format.sh` | PostToolUse (Write\|Edit) | `ruff format` + `ruff check --fix` на изменённый `.py` | агент физически не оставляет неотформатированный код, контекст не тратится |
-| `stop-gate.sh` | Stop | красный `ruff` по прод-путям → exit 2 + хвост ошибок → агент чинит, а не «сдаёт» | обязателен гард `stop_hook_active` (иначе вечный цикл); проверять только СВОЙ домен, не параллельную работу человека |
+| `stop-gate.sh` | Stop | красный `ruff` по прод-путям → exit 2 + хвост ошибок → агент чинит, а не «сдаёт» | обязателен гард `stop_hook_active`; проверять только СВОЙ домен, не параллельную работу человека. Поле настоящее — Stop и SubagentStop получают его на вход; но вечного цикла не будет и без гарда: «Claude Code overrides the hook and ends the turn after 8 consecutive blocks» (code.claude.com/docs/en/hooks, раздел Stop input, сверено 2026-09-07). Цена ошибки — восемь ходов, а не вечность |
 
 - [ ] ⚠️ **Грабля №1 (Windows): `jq` нет в Git Bash.** Хук с `command -v jq || exit 0` молча
       превращается в no-op — защита «есть», но не работает. Парсить JSON через

package/kit/docs/ready-made-rules.md

@@ -174,10 +174,12 @@ ruff check --select TRY400 --statistics .     # сколько находок У
 К осени 2026 появился отдельный класс инструментов — линтеры не кода, а того, что читает агент:
 `AGENTS.md`, `CLAUDE.md`, файлы навыков, конфиги хуков и MCP. Писать своё здесь незачем.
 
-| Инструмент | Что проверяет | Состояние на 2026-09-06 |
+| Инструмент | Что проверяет | Состояние — дата замера в самой ячейке |
 |---|---|---|
-| [`agnix`](https://github.com/agent-sh/agnix) | 455 правил: структура `CLAUDE.md`/`AGENTS.md`/`SKILL.md`, синтаксис конфигов MCP и хуков, соглашения об именах, **мёртвые ссылки на файлы**. Есть автопочинка и LSP | 404 ⭐, Rust, активен. `npm i -g agnix`, `brew`, `pip`, `cargo` |
-| [`agents-lint`](https://github.com/giacomo/agents-lint) | мёртвые npm-скрипты, упомянутые в `AGENTS.md`, устаревшие рамки, деревья каталогов в контексте | 13 ⭐, TypeScript, последний коммит март 2026 |
+| [`agnix`](https://github.com/agent-sh/agnix) | 455 правил: структура `CLAUDE.md`/`AGENTS.md`/`SKILL.md`, синтаксис конфигов MCP и хуков, соглашения об именах, **мёртвые ссылки на файлы**. Есть автопочинка и LSP | 404 ⭐, Rust, активен на 2026-09-06. `npm i -g agnix`, `brew`, `pip`, `cargo` |
+| [`agents-lint`](https://github.com/giacomo/agents-lint) | мёртвые npm-скрипты, упомянутые в `AGENTS.md`, устаревшие рамки, деревья каталогов в контексте | 13 ⭐, TypeScript, последний коммит март 2026 — снято 2026-09-06 |
+| [`claudelint`](https://github.com/pdugan20/claudelint) | 116 правил: схема `.claude/settings.json`, синтаксис правил доступа, имена переменных окружения, ссылки на несуществующие файлы, разбор навыков, плагинов, MCP и LSP. Ловит `"allow": ["*"]` | TypeScript, MIT, коммит 2026-09-08. `npx claude-code-lint`. **Код возврата 0 даже на находке**, если её строгость — `warn`: блокирует только `--strict`. Проверено прогоном 0.8.0 |
+| [`slopcheck`](https://github.com/mattschaller/slopcheck) — **не путать с `0xToxSec/slopcheck`, это разные проекты** | имена npm-пакетов из команд установки в `.md`, `.mdc`, `.yml`, `.yaml`, `.json`, `.cursorrules` сверяет с реестром: пакет, которого не существует, — приманка для захвата имени | MIT, ноль зависимостей, TypeScript, пуш 2026-09-06. `npx slopcheck .`, код возврата 1 на находке — проверено прогоном 0.2.0 от 2026-09-08. Без сети выходит с нулём: «не проверено» у него неотличимо от «чисто» |
 
 ```bash
 npm install -g agnix && agnix --strict .
@@ -187,7 +189,13 @@ npm install -g agnix && agnix --strict .
 формат, существование путей, наличие скриптов. Ни один не спрашивает, **подкреплено ли обещание
 командой с кодом возврата**. «Мы никогда не коммитим секреты» — грамматически безупречная
 строка, на которую ни один из них ничего не скажет. Разделение простое: обвес агента проверяет
-`agnix`, исполнимость обещаний — `promise-has-gate`.
+`agnix`, права и схему настроек — `claudelint`, исполнимость обещаний — `promise-has-gate`.
+
+**Одну дыру в обвесе пришлось закрыть самим.** Имя события хука: ошибка в нём не показывается,
+хук просто не вызывается. У `claudelint` правило `hooks-invalid-event` есть в исходниках, но
+живой прогон версии 0.8.0 на файле с `"PoToolUse"` даёт «No problems found». Замер по 48 чужим
+настройкам нашёл шесть таких хуков в четырёх репозиториях — среди них `typecheck && test` перед
+коммитом, не запускавшийся ни разу. Это запись `hook-actually-fires`.
 
 ## А если проект не на Python?
 
@@ -201,6 +209,23 @@ npm install -g agnix && agnix --strict .
 **Одна строка в существующей записи — самый дешёвый и самый ценный вклад.** Намерение уже
 доказано отказом, образцы уже лежат, проверять нечего кроме самой команды.
 
+## Приёмы агента, названные практиками: чем закрыт каждый
+
+Список взят из разбора 1154 обсуждений с r/programming, r/learnprogramming, r/ExperiencedDevs
+и Hacker News (Baltes, Cheong, Treude, «An Endless Stream of AI Slop», arxiv 2603.27249,
+январь–сентябрь 2025). Это не подборка мнений, а размеченный корпус.
+
+| Приём | Чем закрыт |
+|---|---|
+| «test subversion»: правка теста, чтобы прошёл сломанный код | [`checkwash`](https://github.com/taipei49314/checkwash) — запись `test-not-adjusted` делегирует ему целиком |
+| «deleting methods instead of fixing them» | он же, детектор `TEST_DISABLED` |
+| «casting to `any` to silence type errors» | `@typescript-eslint/no-explicit-any`. Своей записи нет намеренно: замер по `zod` — 769 вхождений на 501 файл, первый прогон даёт стену |
+| «using `setTimeout` as a band-aid fix» | ничем. Замера нет, риск ложных высок: `setTimeout` законен сплошь и рядом |
+| «hallucinating external services, then mocking» | ничем. Отличить выдуманную службу от настоящей статически нечем |
+| выдуманная зависимость (slopsquatting) | [`slopcheck`](https://github.com/mattschaller/slopcheck) — тот, что лежит в npm под этим именем; на нём стоит запись `no-phantom-package`. **Проектов с именем `slopcheck` два**: [`0xToxSec/slopcheck`](https://github.com/0xToxSec/slopcheck) тоже MIT, но последний пуш апрель 2026 и в npm его нет. Проверено 2026-09-08 |
+| подавление проверки без адреса | наш `gate-not-weakened` плюс `eslint-plugin-eslint-comments`, `flake8-noqa` |
+| шаг конвейера, который не может провалиться | наш `ci-actually-fails`; у `checkwash` есть смежный `CI_WORKFLOW_TOUCHED` |
+
 ## Если готового нет
 
 Тогда свой гейт — и в его `README.md` пишется, **что именно проверено**: какой инструмент

package/kit/gates/README.md

@@ -70,6 +70,26 @@
 Плюс шестое, без которого запись не принимается: **доказательство** — реальный отказ, который
 она поймала. «Это хорошая практика» не принимается.
 
+## Находка обязана кончаться действием
+
+Проверка, покрасневшая молча, ничем не лучше молчащей. Проверка, сказавшая «плохо» и не
+сказавшая «делай так», — немногим лучше: человек, открывший тридцать находок, хочет команду,
+а не оценку.
+
+Поэтому последняя строка вывода — совет, и он начинается с метки:
+
+```
+  почини: замени на вызов системы логов — тогда запись попадёт в общий журнал
+```
+
+Приёмка требует эту строку на красном образце, а `doctor --run` печатает её **всегда**: находки
+обрезаются до трёх, совет не обрезается никогда. До этой правки строка существовала для приёмки
+и не существовала для человека — обрезка съедала ровно её.
+
+Требование действует для записей с переносимым рецептом. Запись, целиком делегирующая готовому
+инструменту, печатает вывод этого инструмента, и требовать от чужого вывода нашу строку значит
+требовать невозможного.
+
 ## Зрелость записи не пишут руками
 
 Седьмого поля нет: зрелость **считается** из доказательства. Ссылается `proof` на журнал шишек —
@@ -90,6 +110,24 @@ lifecycle: deprecated
 superseded_by: no-print-in-prod
 ```
 
+## Программа, без которой запись не работает
+
+**`requires:`** называет её явно. Нужно там, где переносимый рецепт — обёртка вокруг готового
+инструмента: первое слово команды тогда `bash`, который есть всегда, и по нему не видно, чего
+не хватает. Без этого поля гейт ставился бы и вставал при первом же запуске с «not found» —
+отсутствие сигнала неотличимо от успеха.
+
+```yaml
+recipes:
+  any: bash {gate}/check.sh {dir}
+requires: checkwash
+```
+
+`add` отказывает с названной причиной и говорит, что поставить. Приёмка и мутационная проверка
+пропускают запись со словами «НЕ ПРОВЕРЕНА здесь — нужен «…»». Строгий режим
+(`AQK_GATES_STRICT=1`, поднят в нашем конвейере) делает такой пропуск ошибкой: на машине,
+которая инструменты сама и ставит, «нечем проверить» обязано быть красным.
+
 ## Запись без переносимого рецепта
 
 Иногда переносимой проверки быть не может: чтобы понять, вызывают ли функцию, нужен граф
@@ -193,6 +231,8 @@ samples_for: python
 | `has_deps: true` | есть файл зависимостей |
 | `has_tests: true` | есть каталог тестов или файлы вида `*_test.*` |
 | `has_env: true` | есть файл окружения |
+| `has_agent_entry: true` | агента здесь используют: есть `CLAUDE.md`, `AGENTS.md`, каталог `.claude`, `.cursor/rules` или инструкции copilot |
+| `has_agent_config: true` | есть настройки самого агента: `.claude/settings.json`, `.claude/settings.local.json`, `.claude/hooks.json`, `.claude/hooks/hooks.json`. Второй файл лежит в `.gitignore` — признак сработает у человека и не сработает в конвейере |
 | `has_ui: true` | есть стили или однофайловые компоненты (`.css`, `.scss`, `.vue`, `.svelte`, `.astro`) |
 
 Любое из `has_*` принимает и `false` — «показывать тем, у кого этого нет». Условие, которого

package/kit/gates/ci-actually-fails/README.md

@@ -29,6 +29,18 @@
 для них — законная настройка, каковой она и является: незаконной её делает то, ЧТО под ней
 стоит, а это знает только проект.
 
+**Исход переспрашивают — маска законна.** `continue-on-error` иногда стоит не ради прощения
+провала, а чтобы дать выполниться шагам ПОСЛЕ проверки; вердикт выносится отдельным шагом
+`if: steps.<id>.outcome == 'failure'` → `exit 1`. Так устроен `pre-commit.yml` в `fastapi`:
+проверка идёт под маской, потом чинит файлы и пушит их в ветку, и только в конце роняет
+сборку. Такой шаг больше не находка. Условие узкое: в файле должна быть И ссылка на исход,
+И падение — переспросить исход и ничего с ним не сделать значит простить провал длиннее на
+три строки, и это по-прежнему красное (образец `red/.github/workflows/soft.yml`).
+
+Замер 2026-09-07 по пяти чужим репозиториям: молчал на всех пяти. На `fastapi` — по
+случайности, слово-примета не совпало с именем шага «Run prek - pre-commit»; назови они его
+«Run lint», гейт покрасил бы законный уклад. Дефект найден разбором молчания, а не находки.
+
 **Чего НЕ ловит.**
 
 - **Проверку, которую не по чему опознать.** Задача `mutation-diff` с именем «Mutation score on

package/kit/gates/ci-actually-fails/check.sh

@@ -33,6 +33,19 @@ fi
 
 BAD=""
 for F in $CI; do
+  # Шаги, чей исход ПЕРЕСПРАШИВАЮТ ниже: `continue-on-error` на них стоит не ради прощения
+  # провала, а чтобы дали выполниться шагам после — а вердикт выносится отдельным шагом
+  # `if: steps.<id>.outcome == 'failure'` → `exit 1`. Найдено замером по fastapi
+  # (`.github/workflows/pre-commit.yml`): проверка идёт под маской, потом чинит файлы и пушит
+  # их в ветку, и только в конце роняет сборку. Гейт молчал там по случайности — слово-примета
+  # не совпало; назови они шаг «lint», он покрасил бы законный уклад.
+  #
+  # Засчитывается только когда в файле есть И ссылка на исход, И падение: переспросить исход и
+  # ничего с ним не сделать — то же самое прощение, только длиннее.
+  REDEEMED=""
+  if tr -d '\r' < "$F" | grep -qE '^[[:space:]]*(-[[:space:]]+)?run[[:space:]]*:.*(exit[[:space:]]+1|^[[:space:]]*false[[:space:]]*$)'; then
+    REDEEMED=$(tr -d '\r' < "$F" | sed -n "s/.*steps\.\([A-Za-z0-9_-]*\)\.\(outcome\|conclusion\|result\).*/\1/p" | sort -u)
+  fi
   # Разбор ПО ШАГАМ, а не по строкам. Построчно проверка врала в обе стороны: законный
   # `continue-on-error` на шаге выгрузки отчёта красил соседний шаг с тестами, а слово «test»
   # внутри перечисления типов коммита («feat|fix|test|chore») делало проверкой строку, которая
@@ -40,7 +53,7 @@ for F in $CI; do
   #
   # Шаг начинается элементом списка («- ») или ключом верхнего уровня: так устроен и github,
   # и gitlab, где `allow_failure` живёт на уровне задачи.
-  RES=$(tr -d '\r' < "$F" | awk -v runners="$RUNNERS" -v words="$WORDS" -v keys="$KEYS" -v file="$F" '
+  RES=$(tr -d '\r' < "$F" | awk -v runners="$RUNNERS" -v words="$WORDS" -v keys="$KEYS" -v file="$F" -v redeemed="$REDEEMED" '
     function isComment(l) { return l ~ /^[[:space:]]*#/ }
     function looksLikeCheck(l,   j, nk) {
       if (isComment(l)) return 0
@@ -62,10 +75,17 @@ for F in $CI; do
       return !isComment(l) && l ~ /^[[:space:]]*(continue-on-error|allow_failure|ignore_failure)[[:space:]]*:[[:space:]]*(true|yes)/
     }
     function isBoundary(l) { return l ~ /^[[:space:]]*-[[:space:]]/ || l ~ /^[A-Za-z_.-]+[[:space:]]*:/ }
+    # Исход этого шага переспрашивают ниже — маска на нём законна.
+    function isRedeemed(id,   j, nr) {
+      if (id == "") return 0
+      nr = split(redeemed, R, "\n")
+      for (j = 1; j <= nr; j++) if (R[j] != "" && R[j] == id) return 1
+      return 0
+    }
     function flush(   ) {
-      if (blockStart && blockCheck && blockMask)
+      if (blockStart && blockCheck && blockMask && !isRedeemed(blockId))
         printf "%s:%d: проверка не может провалиться — шаг под %s\n", file, blockCheckLine, blockMaskText
-      blockStart = 0; blockCheck = 0; blockMask = 0
+      blockStart = 0; blockCheck = 0; blockMask = 0; blockId = ""
     }
     {
       # Гашение прямо в команде красится только для ЗАКРЫТОГО списка запускалок: «|| true» на
@@ -79,6 +99,9 @@ for F in $CI; do
       if (!blockStart) blockStart = NR
       if (!blockCheck && looksLikeCheck($0)) { blockCheck = 1; blockCheckLine = NR }
       if (isMask($0)) { blockMask = 1; blockMaskText = $0; sub(/^[[:space:]]+/, "", blockMaskText) }
+      if (!isComment($0) && $0 ~ /^[[:space:]]*(-[[:space:]]+)?id[[:space:]]*:/) {
+        blockId = $0; sub(/^[^:]*:[[:space:]]*/, "", blockId); gsub(/[[:space:]"'"'"']/, "", blockId)
+      }
     }
     END { flush() }' 2>/dev/null)
   [ -z "$RES" ] || BAD="$BAD$RES

package/kit/gates/ci-actually-fails/green/.github/workflows/ci.yml

@@ -12,3 +12,19 @@ jobs:
       - name: выгрузить отчёт
         run: bash scripts/upload-report.sh
         continue-on-error: true
+
+      # Законный уклад: шаг помечен continue-on-error не для того, чтобы простить провал, а
+      # чтобы дать выполниться шагам после него; вердикт выносится ниже, по его исходу.
+      # Найдено замером по fastapi (.github/workflows/pre-commit.yml): проверка прогоняется
+      # под continue-on-error, потом чинит файлы и пушит их в ветку, а в конце падает, если
+      # проверка была красной. Гейт, красящий такое, требует убрать то, без чего уклад не
+      # работает, — и его выключат целиком.
+      - name: линтер
+        id: lint
+        run: ruff check .
+        continue-on-error: true
+      - name: применить починки и запушить
+        run: bash scripts/push-fixes.sh
+      - name: провалить сборку, если линтер был красным
+        if: steps.lint.outcome == 'failure'
+        run: exit 1

package/kit/gates/ci-actually-fails/red/.github/workflows/soft.yml

@@ -0,0 +1,15 @@
+# Исход проверки переспрашивают — и ничего с ним не делают. Ровно то же прощение, что и
+# голый continue-on-error, только длиннее на три строки и убедительнее на вид.
+name: soft
+on: [push]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: линтер
+        id: lint
+        run: ruff check .
+        continue-on-error: true
+      - name: сказать вслух
+        if: steps.lint.outcome == 'failure'
+        run: echo "линтер был красным"

package/kit/gates/color-from-token/check.sh

@@ -5,7 +5,19 @@
 # который в тёмной теме остаётся светлым пятном, — и это видно не автору, а пользователю,
 # который переключил тему. Дефект тихий: в теме автора всё выглядит правильно.
 DIR="${1:-.}"
-. "$(dirname "$0")/../_skip.sh" 2>/dev/null || SKIP_NAMES=".git .aqk node_modules .venv"
+# Существование файла проверяется ДО `.`, а не запасной веткой после. Прежняя строка
+# `. файл 2>/dev/null || запасной_вариант` выглядела страховкой и ею не была: под `sh` (dash)
+# неудачный `.` завершает скрипт немедленно, и ветка после `||` не выполняется никогда; под
+# `bash`, которым гейты и запускаются из манифеста, она выполняется, но подставляет только
+# ПЕРЕМЕННУЮ — функции обхода остаются неопределёнными, конвейер печатает пустоту, и проверка
+# выходит с НУЛЁМ. Замерено 2026-09-08 на файле с настоящим нарушением: гейт сказал «чисто».
+SKIP_LIB="$(dirname "$0")/../_skip.sh"
+if [ ! -f "$SKIP_LIB" ]; then
+  echo "рядом с проверкой нет _skip.sh — обход не собран, проверка не состоялась"
+  echo "  почини: скопируй гейт вместе с файлом kit/gates/_skip.sh, он общий на весь каталог"
+  exit 2
+fi
+. "$SKIP_LIB"
 
 # Расширения, где живёт ТЕМИЗИРУЕМЫЙ интерфейс. Своё, а не общий CODE_EXT: там нет ни css, ни
 # vue — они не код в смысле «отладочная печать», но именно в них живёт цвет.

package/kit/gates/commit-explains-itself/README.md

@@ -12,8 +12,18 @@
 **Почему машина, а не внимательность.** Написать отчёт «на будущее» — первое, что пропускают под
 давлением дедлайна. Гейт делает это ценой, а не пожеланием.
 
-**Готовый аналог.** Не искал: это не класс проверок, который держат готовые линтеры — они читают
-код, а не историю коммитов.
+**Готовый аналог есть, и раньше здесь было написано «не искал».** Искали 2026-09-07, при ревизии
+каталога. Историю коммитов держат [`gitlint`](https://jorisroovers.com/gitlint/) и
+[`commitlint`](https://commitlint.js.org/): проверяют форму заголовка, тип по Conventional
+Commits, длину строк, пустую строку между заголовком и телом; у `gitlint` есть даже
+`body-min-length` и возможность дописать своё правило на Python.
+
+**Почему рецепта под них здесь нет.** Оба проверяют, что тело **есть** и как оно оформлено. Эта
+запись требует другого: чтобы в теле стояли два названных раздела — что сделано и **в чём агент
+не уверен**. Второго нет ни в Conventional Commits, ни во встроенных правилах обоих. Написать
+своё правило `gitlint` можно, но это код на Python в проекте, который может быть не на Python, —
+и он всё равно наш, только в чужой обёртке. Если `commitlint` у вас уже стоит — он закрывает
+форму заголовка, чего не делаем мы; записи это не отменяет.
 
 **Чего НЕ ловит.** Не проверяет качество отчёта, только его наличие — «Сделано: починил» и «Не
 уверен: не знаю» формально пройдут. Не проверяет, что отчёт правдив. Это ограничение того же
@@ -39,7 +49,7 @@
 
 Гейт всё-таки местный: подсказка «допиши в тело коммита» выполнима до пуша, а не после.
 
-**Образцы.** `red/COMMIT_MSG` — обычное тело коммита без отчёта. `green/COMMIT_MSG` — то же самое
+**Образцы.** `red/.aqk-commit-msg` — обычное тело коммита без отчёта. `green/.aqk-commit-msg` — то же самое
 плюс `Сделано:` и `Не уверен:`. Образцы — текстовые файлы, а не настоящий git: арбитр в реальном
 проекте читает `git log -1`, а вложенный `.git` внутри каталога комплекта создал бы embedded-
 репозиторий, который сам по себе стал бы проблемой версионирования.

package/kit/gates/commit-explains-itself/check.sh

@@ -4,11 +4,15 @@
 # оставляет след для человека, читающего историю позже.
 DIR="${1:-.}"
 
-# Образцы (gates.sh) читают тело коммита из файла — реальный git log там взять неоткуда, а
+# Образцы (gates.sh) читают тело коммита из `.aqk-commit-msg` — реальный git log там взять неоткуда, а
 # вложенный .git внутри каталога комплекта сам по себе создал бы embedded-репозиторий.
-# В настоящем проекте COMMIT_MSG не бывает — читается последний реальный коммит.
-if [ -f "$DIR/COMMIT_MSG" ]; then
-  MSG=$(cat "$DIR/COMMIT_MSG")
+# В настоящем проекте такого файла не бывает — читается последний реальный коммит.
+# Имя с точкой намеренно: `COMMIT_MSG` в корне проекта — вещь возможная (так зовут заготовку
+# сообщения многие обёртки над git), и такой файл молча подменял бы собой настоящий коммит.
+# Тот же дефект нашло ревью у `personal-config-not-shared` 2026-09-07; здесь он был с самого
+# начала и не всплывал.
+if [ -f "$DIR/.aqk-commit-msg" ]; then
+  MSG=$(cat "$DIR/.aqk-commit-msg")
 else
   if ! (cd "$DIR" 2>/dev/null && git rev-parse --git-dir >/dev/null 2>&1); then
     echo "не git-репозиторий — проверять нечего"

package/kit/gates/complexity-limit/README.md

@@ -33,5 +33,10 @@
 считает только глубину. Не различает функции внутри файла: меряется худшее место файла, а не
 каждая функция отдельно. Готовые правила умеют и то, и другое.
 
+**Тесты не проверяются.** Глубокая вложенность в тесте — это обход таблицы ожиданий, а не
+сложная логика. Замер по `fastapi` дал 303 находки, из которых **101 в `tests/`**; после
+исключения тестов осталось 10. Гейт, который краснеет в основном на тестах, выключают целиком —
+тот же довод и по той же причине, что в `duplicate-code`.
+
 **Образцы.** `red/` — восемь уровней вложенности. `green/` — тот же смысл, разбитый на две
 функции с ранним выходом.

package/kit/gates/complexity-limit/check.sh

@@ -6,11 +6,30 @@
 # ЗАЧЕМ ВООБЩЕ. 29 ветвлений в одной функции — это код, который никто не держит в голове
 # целиком: ни человек, ни агент. Агент в таком месте начинает переписывать вместо правки.
 DIR="${1:-.}"
-. "$(dirname "$0")/../_skip.sh" 2>/dev/null || SKIP_NAMES=".git .aqk node_modules .venv"
+# Существование файла проверяется ДО `.`, а не запасной веткой после. Прежняя строка
+# `. файл 2>/dev/null || запасной_вариант` выглядела страховкой и ею не была: под `sh` (dash)
+# неудачный `.` завершает скрипт немедленно, и ветка после `||` не выполняется никогда; под
+# `bash`, которым гейты и запускаются из манифеста, она выполняется, но подставляет только
+# ПЕРЕМЕННУЮ — функции обхода остаются неопределёнными, конвейер печатает пустоту, и проверка
+# выходит с НУЛЁМ. Замерено 2026-09-08 на файле с настоящим нарушением: гейт сказал «чисто».
+SKIP_LIB="$(dirname "$0")/../_skip.sh"
+if [ ! -f "$SKIP_LIB" ]; then
+  echo "рядом с проверкой нет _skip.sh — обход не собран, проверка не состоялась"
+  echo "  почини: скопируй гейт вместе с файлом kit/gates/_skip.sh, он общий на весь каталог"
+  exit 2
+fi
+. "$SKIP_LIB"
 MAX="${AQK_MAX_DEPTH:-5}"
 
+# Тесты исключены намеренно — тем же списком, что и в duplicate-code. Глубокая вложенность в
+# тесте это обход таблицы ожиданий, а не сложная логика: замер по fastapi дал 303 находки, из
+# которых 101 в tests/. Гейт, который краснеет в основном на тестах, выключают целиком.
+TESTS="-name test -prune -o -name tests -prune -o -name spec -prune -o -name __tests__ -prune -o"
+
 # shellcheck disable=SC2046
-find "$DIR" $(skip_find "$DIR") -type f -print 2>/dev/null | only_code | own_samples_filter "$DIR" \
+find "$DIR" $(skip_find "$DIR") $TESTS -type f \
+     ! -name 'test_*' ! -name '*_test.*' ! -name '*.test.*' ! -name '*.spec.*' \
+     -print 2>/dev/null | only_code | own_samples_filter "$DIR" \
   | while IFS= read -r F; do is_generated "$F" || printf '%s\n' "$F"; done \
   | xargs -r awk -v MAX="$MAX" '
         # Один обход на все файлы: процесс на каждый файл дал 19 секунд на 4000 файлов.

package/kit/gates/complexity-limit/green/test_fixtures.py

@@ -0,0 +1,14 @@
+# Тест с глубокой вложенностью — не сложная логика, а разбор дерева ожиданий. Найдено замером
+# по fastapi: 101 находка из 303 пришлась на tests/, и все они — таблицы ожидаемых ответов,
+# которые никто не станет «упрощать». Гейт, который краснеет в основном на тестах, выключат.
+def test_openapi_schema(client):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200
+    schema = response.json()
+    for path, methods in schema["paths"].items():
+        for method, spec in methods.items():
+            for code, resp in spec["responses"].items():
+                if "content" in resp:
+                    for media, body in resp["content"].items():
+                        if "schema" in body:
+                            assert body["schema"] is not None

package/kit/gates/deps-are-pinned/README.md

@@ -26,4 +26,17 @@
 **Готового аналога нет** — ни в линтерах, ни в пакетных менеджерах: они
 умеют создать файл версий, но не умеют требовать, чтобы он существовал и лежал в репозитории.
 
-**Образцы.** `red/` — объявление зависимостей без закрепления. `green/` — с ним.
+**Закрепляют не только poetry и uv.** Для `pyproject.toml` файлом закрепления считается и
+`requirements.txt` — но только если он сам проходит проверку, то есть все версии в нём стоят
+через `==`. Иначе «есть requirements.txt» стало бы способом обойти гейт пустым файлом.
+Найдено замером по `httpx`: там инструменты закреплены до патча прямо в `requirements.txt`,
+а гейт требовал ещё и `poetry.lock`, которого в этом укладе не бывает вовсе.
+
+**Не различает библиотеку и приложение.** Библиотека намеренно оставляет
+границы своих зависимостей широкими — закрепив их у себя, она ломает сборку всем, кто её
+ставит. Гейт смотрит только на то, закреплено ли окружение самого проекта, и правильно молчит,
+когда библиотека закрепила инструменты и не закрепила зависимости.
+
+**Образцы.** `red/` — объявление зависимостей без закрепления, плюс `pyproject.toml` рядом с
+незакреплённым `requirements.txt`. `green/` — с закреплением, включая уклад «pyproject плюс
+requirements.txt с точными версиями».

package/kit/gates/deps-are-pinned/check.sh

@@ -30,7 +30,12 @@ need() {
 }
 
 need package.json  package-lock.json yarn.lock pnpm-lock.yaml npm-shrinkwrap.json
-need pyproject.toml poetry.lock uv.lock pdm.lock
+# requirements.txt считается закреплением для pyproject.toml наравне с файлами блокировки:
+# закрепляют не только poetry и uv. Замер по httpx: инструменты там закреплены до патча
+# прямо в requirements.txt, а гейт требовал ещё и poetry.lock, которого в этом укладе не
+# бывает вовсе. Файл засчитывается только если он сам проходит проверку ниже — иначе
+# «есть requirements.txt» стало бы способом обойти гейт пустым файлом.
+need pyproject.toml poetry.lock uv.lock pdm.lock requirements.txt
 need go.mod        go.sum
 need Cargo.toml    Cargo.lock
 need Gemfile       Gemfile.lock

package/kit/gates/deps-are-pinned/green/pyproject-with-requirements/pyproject.toml

@@ -0,0 +1,12 @@
+# Питоновская библиотека, которая закрепляет версии не файлом блокировки, а точными версиями
+# в requirements.txt. Так делает httpx и весь класс проектов, живущих без poetry и uv:
+# инструменты закреплены до патча, а границы зависимостей самой библиотеки оставлены широкими
+# намеренно — библиотека, закрепившая их у себя, ломает сборку всем, кто её ставит.
+[project]
+name = "sample-lib"
+version = "1.0.0"
+dependencies = ["httpx"]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"

package/kit/gates/deps-are-pinned/green/pyproject-with-requirements/requirements.txt

@@ -0,0 +1,3 @@
+-e .
+pytest==8.4.1
+ruff==0.16.6

package/kit/gates/deps-are-pinned/red/pyproject-loose/pyproject.toml

@@ -0,0 +1,12 @@
+# Питоновская библиотека, которая закрепляет версии не файлом блокировки, а точными версиями
+# в requirements.txt. Так делает httpx и весь класс проектов, живущих без poetry и uv:
+# инструменты закреплены до патча, а границы зависимостей самой библиотеки оставлены широкими
+# намеренно — библиотека, закрепившая их у себя, ломает сборку всем, кто её ставит.
+[project]
+name = "sample-lib"
+version = "1.0.0"
+dependencies = ["httpx"]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"

package/kit/gates/deps-are-pinned/red/pyproject-loose/requirements.txt

@@ -0,0 +1,3 @@
+-e .
+pytest>=8
+ruff

package/kit/gates/duplicate-code/README.md

@@ -12,13 +12,22 @@
 **Почему агенты плодят дубли особенно охотно.** Скопировать из соседнего файла дешевле, чем
 найти общее место и вынести туда: копия точно работает, вынесение может что-то сломать.
 
-**Готовый аналог есть.** `jscpd` умеет и Python, и TypeScript одним прогоном и считает
-**похожесть**, а не только точное совпадение. Рецепты под фронтовые стеки берут его.
+**Готовый аналог есть, и под каждый стек свой.** `jscpd` для фронта — считает **похожесть**, а не
+только точное совпадение. `pylint --enable=R0801` для Python — сравнивает разобранный код, и
+переименованная переменная его не обманет. Рецепт под Python появился только 2026-09-07: до
+ревизии каталога его не было вовсе, и питоновский проект получал нашу побайтовую самоделку,
+хотя родной инструмент стоял у него уже установленным.
 
 **Переносимая проверка грубее.** Она ищет одинаковые восемь строк подряд после снятия отступов —
 совпадение байт в байт. Копия с переименованной переменной её не насторожит. Это запасной
 вариант, а не замена.
 
+**Одинаковые импорты — не дубль.** Окно, в котором нет ни одной строки кроме ввоза (`import`,
+`use`, `require`, путь в кавычках внутри `import (…)` в Go) и одиноких скобок, находкой не
+считается. Найдено замером по `cobra`: гейт краснел на `doc/man_docs.go` и `doc/md_docs.go`,
+где совпадали восемь строк подряд из списка импортов и ни одной строки логики. В Go, Java и Rust
+ввоз стоит по одной строке на строку, и в соседних файлах одного пакета он совпадает всегда.
+
 **Тесты не проверяются.** Повтор в тестах часто осознанный: читаемость важнее сухости, и три
 похожих теста лучше одного хитрого. Случай «три однотипных — свести в один с набором входов»
 решается по правилам тестирования и глазами. На живом проекте **все двадцать находок были в