К основному содержанию
affpapa.org
RU EN
скилл Claude Code CX Codex Cursor GitHub Copilot

adr-verify — скилл для Claude Code: проверка графа ADR

Читает сохранённый граф ADR из памяти и находит битые ссылки, циклы замены и несовпадения статусов. Пригодится сразу после adr-index и как гейт в CI.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓ 
npx skills add ruvnet/ruflo --skill adr-verify -a claude-code
Открыть на GitHub

Что делает adr-verify

Скилл читает то, что adr-index записал в пространства памяти adr-patterns и adr-edges, и ищет три вида поломок: ссылки на несуществующий ADR, циклы замены (ADR-A заменяет ADR-B и наоборот) и записи, где ADR служит источником ребра supersedes, но статус у него так и не стал Superseded. Обычная причина последнего — забыли обновить статус при продвижении ADR-наследника.

Запуск — одна строка: node plugins/ruflo-adr/scripts/verify.mjs. По умолчанию код выхода 1 только при найденном цикле; VERIFY_STRICT=1 роняет прогон на любой проблеме, VERIFY_FORMAT=json переключает отчёт с markdown на JSON. Разрешения скилла ограничены Bash и двумя инструментами памяти, файлы он не правит.

Есть слепое пятно: строка в adr-patterns для ADR, удалённого с диска, у которой нет ни одного ребра ни в одну сторону, не видна ни одной проверке. Если счётчик ADR в отчёте больше, чем файлов на диске, гонять adr-verify второй раз бессмысленно — нужен adr-reindex. И проверять есть что только после импорта, потому что оба пространства заполняет adr-index.

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

  • поймать ребро, ведущее на ADR, которого нет в графе
  • найти цикл взаимной замены между ADR
  • вычистить записи, где статус забыли перевести в Superseded
  • поставить fail-closed гейт в CI перед релизом ADR
  • получить отчёт в JSON для внешнего скрипта

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

  • Прогони `node plugins/ruflo-adr/scripts/verify.mjs` и покажи отчёт по графу ADR.
  • Запусти проверку со `VERIFY_STRICT=1`, чтобы сборка падала на любой проблеме, а не только на цикле.
  • Сделай отчёт через `VERIFY_FORMAT=json` и перечисли все циклы замены.

Как установить adr-verify

1Через Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill adr-verify -a claude-code

2Вручную: положить файлы

~/.claude/skills/adr-verify/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/adr-verify/

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

Весь набор →
ruflo ruvnet Скилл добавляет в проект оркестрацию мультиагентных задач, память, маршрутизацию и MCP-инструменты. Нужен для swarm-сценариев и многошаговых workflows. Claude Code CX Codex Cursor +1 4 000установок Swarm Orchestration ruvnet Скилл для управления роями агентов с параллельным выполнением задач, динамической топологией и автоматической балансировкой нагрузки. Нужен, когда одного агента недостаточно и требуется координировать специалистов разного профиля. Claude Code CX Codex Cursor +1 2 100установок github-project-management ruvnet Скилл превращает рутину вокруг issue и доски проекта в вызовы gh и ruv-swarm: метки, подзадачи, поиск дублей. Пригодится, когда задач много, а порядка в трекере нет. Claude Code CX Codex Cursor +1 1 400установок github-workflow-automation ruvnet Скилл автоматизирует GitHub Actions с координацией AI-агентов. Генерирует оптимальные pipeline, управляет pull request'ами, анализирует баги и развёртывает обновления с минимальными рисками. Claude Code CX Codex Cursor +1 1 300установок github-code-review ruvnet Организует параллельное код-ревью в GitHub с помощью агентов безопасности, архитектуры и стиля через пакет ruv-swarm. Claude Code CX Codex Cursor +1 1 300установок stream-chain ruvnet Организует последовательную передачу данных между шагами агента через цепочки промптов или готовые пайплайны. Claude Code CX Codex Cursor +1 1 200установок flow-nexus-swarm ruvnet Развёртывает облачные рои ИИ-агентов и собирает событийные процессы с очередями сообщений. Нужен для координации задач, контроля запусков и масштабирования роя. Claude Code CX Codex Cursor +1 1 200установок performance-analysis ruvnet Находит узкие места в Claude Flow swarms, профилирует операции агентов и генерирует отчёты с рекомендациями по оптимизации. Claude Code CX Codex Cursor +1 1 200установок

Похожие

skill-review sanyuan0704 Проверяет структуру, описания и расход токенов в скиллах Claude Code. Находит антипаттерны и даёт точечные правки. Claude Code CX Codex Cursor +1 2 200установок google-drive-automation sanjay3290 Даёт агенту читать и записывать файлы в Google Drive через два локальных скрипта и отдельную OAuth-авторизацию. MCP-сервер не нужен. Claude Code CX Codex Cursor +1 909установок cli-anything-inkscape HKUDS Скилл даёт агенту интерфейс командной строки для редактирования векторной графики Inkscape через JSON-проекты и манипуляции с SVG. Claude Code CX Codex Cursor +1 599установок godot-nodes-scenes gamedev-skills Учит агента собирать проект Godot 4.7 из узлов и сцен: делать переиспользуемые .tscn, ставить инстансы в рантайме и не падать на удалённых узлах. Claude Code CX Codex Cursor +1 6 200установок setup-matt-pocock-skills Matt Pocock Скилл настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. Claude Code 1 052 851установок to-tickets Matt Pocock Разбивает план, спецификацию или переписку на небольшие сквозные задачи и отмечает, какие из них блокируют остальные. Пригодится, когда нужно согласовать порядок работы до публикации задач в трекере. Claude Code 711 230установок writing-plans Jesse Vincent Скилл превращает требования к многошаговой задаче в подробный план реализации до начала работы с кодом. Пригодится, когда исполнителю нужно зафиксировать файлы, интерфейсы и проверки. Claude Code CX Codex 282 859установок stitch-loop официальный google-labs-code Организует автономную сборку страниц через Stitch MCP. Агент берёт задачу из файла-эстафеты, создаёт экран, переносит код в проект и сразу пишет задание для следующей итерации. Claude Code CX Codex Cursor +1 56 300установок

Вопросы о adr-verify

Как установить adr-verify в Claude Code?

Выполни npx skills add ruvnet/ruflo --skill adr-verify -a claude-code. Скилл окажется в ~/.claude/skills/adr-verify/SKILL.md.

Что делает adr-verify?

Читает пространства adr-patterns и adr-edges после импорта и показывает битые ссылки, циклы замены и ADR с необновлённым статусом. При цикле выходит с кодом 1.

Чем adr-verify отличается от adr-reindex?

adr-reindex нужен, когда в adr-patterns осталась строка удалённого ADR без единого ребра — такую запись проверка не замечает. adr-verify работает по уже собранному графу.

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

SKILL.md · MIT 
---
name: adr-verify
description: Read back adr-patterns + adr-edges namespaces, surface dangling refs / supersede cycles / Unknown statuses; exit 1 on cycles
argument-hint: ""
allowed-tools: Bash mcp__plugin_ruflo-core_ruflo__memory_list mcp__plugin_ruflo-core_ruflo__memory_retrieve
---

# ADR Verify

Companion to `adr-index`. After import, reads the persisted graph and surfaces integrity issues:

- **Dangling refs** — edge points at an ADR ID that doesn't exist in `adr-patterns`. Common cause: the referenced ADR is in a sibling repo or got deleted.
- **Supersede cycles** — `ADR-A supersedes ADR-B` and `ADR-B supersedes ADR-A` (or longer cycles). Always data corruption.
- **Status mismatches** — an ADR is the source of a `supersedes` edge but its own status isn't `Superseded`. Usually a missed status update during a successor ADR's promotion.

**What this skill cannot catch:** an `adr-patterns` row for an ADR that was deleted from disk and has zero edges referencing it or from it — invisible to every check above (issue #2666). If the reported ADR count looks higher than what's actually on disk, run `adr-reindex`, not `adr-verify` again.

## When to use

- Right after `adr-index` to confirm the graph is healthy
- In CI as a fail-closed gate (`VERIFY_STRICT=1` exits 1 on any issue)
- Before publishing an ADR-related release

## Steps

```bash
node plugins/ruflo-adr/scripts/verify.mjs
```

Optional env:
- `VERIFY_FORMAT=json` — JSON instead of markdown
- `VERIFY_STRICT=1` — exit 1 on ANY issue (default: only on cycles)

## Exit codes

| Code | Meaning |
|---|---|
| `0` | Graph healthy (or dangling refs / status mismatches present in non-strict mode) |
| `1` | Supersede cycle detected, OR strict mode + any issue present |

## Cross-references

- `adr-index` — populates the data this skill verifies
- `scripts/import.mjs` — has its own dry-run validation; this skill is the read-back companion
- `adr-reindex` — reconciles a deleted ADR that `adr-verify` cannot detect

© ruvnet · MIT · ruvnet/ruflo

Смотрите также

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

Компании, которые помогают держать аналитику открытой
Золотой спонсор AI-аналитика спроса на iGaming — индекс, тренды, конкуренты
Nutra.Club Закрытое сообщество Nutra-вертикали от команды M1

Показы, клики и копирования кода — открытая статистика. Мы держим цифры публичными по той же логике, что и сам NeBlask. Стать спонсором