К основному содержанию
плагин

dead-rules-audit — плагин для Claude Code: что делает и как установить

Плагин dead-rules-audit аудирует соблюдение правил из CLAUDE.md во время сессии Claude Code и отмечает правила, которые агент постоянно игнорирует.

MIT ★ 586 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add karanb192/claude-code-hooks
/plugin install dead-rules-audit@claude-code-hooks
Открыть на GitHub

Что делает dead-rules-audit

Плагин разбирает ближайший файл CLAUDE.md на отдельные правила при старте сессии. При каждом вызове инструментов Edit, MultiEdit или Write асинхронный хук PostToolUse сопоставляет правки с правилами и записывает результат в локальный JSONL-журнал. Анализ выполняется эвристиками по ключевым словам и шаблонам: плагин не отправляет запросы к моделям и не обращается к сети.

В конце сессии или по запросу инструмент выводит сводку нарушений с процентом соблюдения. Для правил с частыми сбоями появляется флаг ⚠ promote→hook. Пороги заданы константами в скрипте: флаг срабатывает при минимум 3 нарушениях и доле нарушений от 0.5. Также действуют лимиты в 200 правил и 256 КБ на размер файла CLAUDE.md.

Вся статистика хранится локально в директории ~/.claude/dead-rules-audit/ и системных журналах хуков. Никаких внешних зависимостей и ключей API для запуска не требуется.

Какие задачи решает

  • найти бесполезные или игнорируемые правила в CLAUDE.md
  • посчитать процент соблюдения инструкций при редактировании кода
  • выявить кандидатов на перенос из текстовых правил в детерминированные хуки

Примеры запросов агенту

  • /dead-rules-audit:scorecard
  • Покажи сводку соблюдения правил CLAUDE.md за текущую сессию
  • Какие правила из CLAUDE.md нарушались чаще всего?

Как установить dead-rules-audit

Через маркетплейс плагинов

/plugin marketplace add karanb192/claude-code-hooks
/plugin install dead-rules-audit@claude-code-hooks

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о dead-rules-audit

Как установить dead-rules-audit в Claude Code?

Выполните обе команды по очереди: сначала /plugin marketplace add karanb192/claude-code-hooks, затем /plugin install dead-rules-audit@claude-code-hooks, после чего перезапустите Claude Code.

Что делает dead-rules-audit?

Он парсит CLAUDE.md, пассивно считает соблюдение правил при изменениях файлов и формирует карточку с оценкой качества их выполнения.

Отправляет ли плагин данные на внешние серверы?

Нет, плагин использует встроенные модули Node.js, работает полностью локально без сетевых вызовов и обращений к сторонним API.

Исходный текст

dead-rules-audit · MIT
# dead-rules-audit

> A CLAUDE.md compliance scorecard that tallies which rules Claude actually follows vs ignores as you edit, and flags chronically-ignored rules to promote into a deterministic hook.

At SessionStart it finds the nearest CLAUDE.md and parses it into numbered atomic rules, snapshotting which loaded this session. On every Edit/MultiEdit/Write a PostToolUse hook scores the change against each rule and tallies, per rule, how often it was relevant and whether it was followed or violated, appending to a local JSONL ledger. The judgement is a deterministic keyword/pattern heuristic: no model call, no network. At SessionEnd it renders a worst-first compliance scorecard (rule text, times relevant, times violated, compliance %, and a `⚠ promote→hook` flag for chronically-ignored rules) and persists it. You can also re-render on demand.

## Install

```
/plugin marketplace add karanb192/claude-code-hooks   # once per machine
/plugin install dead-rules-audit@claude-code-hooks
```

Restart Claude Code, done. (Or from a shell: `claude plugin install dead-rules-audit@claude-code-hooks`.)

## What it does

| Event | Runs | What happens |
|-------|------|--------------|
| SessionStart | sync | Parse CLAUDE.md into numbered atomic rules; snapshot which rules loaded this session. |
| PostToolUse (`Edit\|MultiEdit\|Write`) | async (zero added latency) | Score the change against each rule; update per-rule relevant/followed/violated tallies in the ledger. |
| SessionEnd | sync | Render the worst-first compliance scorecard and persist it. |

`/dead-rules-audit:scorecard` renders the worst-first compliance scorecard on demand, highlighting the worst offenders and any `promote→hook` rules.

## Configuration

No configuration needed. There are no environment variables or settings. Tuning thresholds are hard-coded constants at the top of `dead-rules-audit.js`: the `promote→hook` flag fires at `PROMOTE_MIN_VIOLATIONS = 3` violations and `PROMOTE_RATE = 0.5` violation rate, with `MAX_CLAUDE_MD_BYTES = 256 * 1024` and `MAX_RULES = 200` guards. Tally state is stored in `~/.claude/dead-rules-audit/` (scorecard entries are also logged to `~/.claude/hooks-logs/<date>.jsonl`).

## Data & privacy

It records your CLAUDE.md rule text and per-rule relevant/followed/violated tallies. Everything stays on the local machine: the source requires only `fs`, `path`, `os`, and `crypto`, makes zero network calls, and is fully deterministic.

## Uninstall

```
/plugin uninstall dead-rules-audit@claude-code-hooks
```

© Karan Bansal · MIT · karanb192/claude-code-hooks

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
fda-qsr-audit-prep Alireza Rezvani Скилл fda-qsr-audit-prep прогоняет шесть вопросов аудита FDA 21 CFR 820 перед внутренней проверкой, инспекцией или ответом на Form 483. CX Codex +1 17установок dd-audit datadog-labs Скилл dd-audit для Claude Code, который расследует изменения и подозрительную активность через Audit Trail в Datadog. Работает с запросами вроде «кто удалил дашборд» или «что делал этот ключ API». CX Codex +1 803установок isms-audit-expert Alireza Rezvani Скилл isms-audit-expert для проверки соответствия ISO 27001, оценки контролей безопасности и подготовки к сертификации. Помогает документировать находки аудита, классифицировать несоответствия и управлять корректирующими действиями. CX Codex +1 791установок security-compliance-audit aj-geddes Скилл security-compliance-audit для Claude Code проверяет соответствие SOC 2, GDPR, HIPAA, PCI-DSS и ISO 27001. Оценивает контроли, политики и процедуры перед сертификацией или ежегодной проверкой. CX Codex +1 676установок dd-audit-ai-activity datadog-labs Скилл dd-audit-ai-activity для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который выгружает из Datadog Audit Trail всё, что сделал MCP-ассистент Bits AI: вызовы инструментов, затронутые ресурсы и флаги аномалий. CX Codex +1 515установок ai-agent-audit-specialist davila7 Субагент ai-agent-audit-specialist проектирует и проверяет неизменяемые аудиторские журналы для ИИ-агентов под требования HIPAA, SOC 2, ISO 27001 и EU AI Act. CX Codex 148установок

Из того же набора28

Весь набор →
protect-secrets Плагин protect-secrets для Claude Code проверяет вызовы Read, Edit, Write, Bash и Grep и блокирует доступ к секретам или сначала запрашивает разрешение. ★ 586звёзд репо bounty-board Плагин bounty-board превращает TODO и FIXME в вашем коде в растущие по возрасту XP-бонусы. Плагин сканирует репозиторий, оценивает долг в очки и подсказывает три самых прибыльных задачи прямо в сессии. ★ 586звёзд репо dead-end-registry Плагин dead-end-registry сохраняет отменённые решения и предупреждает, если вы или модель снова пытаетесь пойти по тупиковому пути. Помогает не тратить токены на повторные ошибки. ★ 586звёзд репо standup-autopilot Плагин standup-autopilot собирает задачи, тесты, PR и блокеры из транскриптов сессий и оформляет сводку для дейли. Открытые блокеры возвращаются в следующую сессию. ★ 586звёзд репо pr-provenance-stamp Плагин pr-provenance-stamp дописывает в тело пулл-реквеста квитанцию: число промптов, оценку расхода, коды возврата тестов и долю строк, написанных агентом. ★ 586звёзд репо nerf-receipts Плагин nerf-receipts считает сбои инструментов, повторные правки одного файла и токены на задачу. Помогает увидеть, меняются ли эти показатели вместе со сменой модели. ★ 586звёзд репо cache-tax Плагин cache-tax показывает, во сколько обойдётся возврат в сессию после того, как часовой кеш промпта остыл, — до того, как вы нажмёте Enter. ★ 586звёзд репо context-hogs Плагин context-hogs считает расход токенов по файлам проекта и показывает отчёт с самыми затратными местами. ★ 586звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой