Скилл adr-create для Claude Code: ADR с нумерацией и AgentDB
Пишет Architecture Decision Record в docs/adr/ со следующим номером, кладёт его в память AgentDB и связывает с прежними решениями. Пригодится, когда решение надо записать и не потерять.
npx skills add ruvnet/ruflo --skill adr-create -a claude-codeЧто делает adr-create
Скилл берёт заголовок, ищет в docs/adr/ файлы ADR-*.md и определяет следующий номер. Заголовок превращается в слаг, файл ложится по пути docs/adr/ADR-NNN-<slug>.md. Папки нет — она появится.
Внутри стандартный шаблон: статус proposed, дата, блок для тех, кто принимал решение, и теги, а дальше контекст, решение и последствия в трёх разрезах с разделом ссылок. Потом скилл сохраняет запись под ключом mem:ADR-NNN на уровне semantic, ищет похожие решения в пространстве adr-patterns и добавляет к каждому найденному связь depends-on.
Граф работает только при подключённом MCP-сервере ruflo: шаги с agentdb_hierarchical-store, memory_search и causal-edge дёргают его инструменты. Без сервера markdown-файл всё равно создастся, а регистрация и связи не появятся. Вот и повод проверить список MCP-серверов до первого запуска.
Какие задачи решает
- завести ADR с правильным следующим номером в
docs/adr/ - получить заготовку с контекстом, решением и последствиями
- связать новое решение с прежними записями по теме
- найти прошлые ADR по заголовку через
adr-patterns - оставить решение в памяти агента, чтобы его подхватили другие сессии
Примеры запросов агенту
- Создай ADR: переход на PostgreSQL для хранения заказов
- Оформи как ADR решение вынести платежи в отдельный сервис и свяжи с прошлыми
- adr-create Кэширование сессий в Redis
Как установить adr-create
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill adr-create -a claude-code2Вручную: положить файлы
~/.claude/skills/adr-create/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/adr-create/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill adr-create -a codex2Вручную: положить файлы
.agents/skills/adr-create/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill adr-create -a cursor2Вручную: положить файлы
.cursor/skills/adr-create/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo adr-create2Вручную: положить файлы
.github/skills/adr-create/SKILL.md1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill adr-create -a gemini-cli2Командой платформы
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-adr/skills/adr-createВручную: положить файлы
.devin/skills/adr-create/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill adr-create -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора104
Весь набор →Похожие
Вопросы о adr-create
Как установить adr-create в Claude Code?
Выполните npx skills add ruvnet/ruflo --skill adr-create -a claude-code. После этого скилл лежит в ~/.claude/skills/adr-create/SKILL.md.
Что делает adr-create?
Создаёт файл ADR со следующим порядковым номером по шаблону, регистрирует решение в AgentDB и проставляет связи с похожими ADR из adr-patterns.
Что нужно, чтобы заработала регистрация в AgentDB?
Подключённый MCP-сервер ruflo с инструментами agentdb_hierarchical-store, memory_search и causal-edge. Без него останется только markdown-файл.
Исходный текст
SKILL.md · MIT
---
name: adr-create
description: Create a new Architecture Decision Record with sequential numbering and AgentDB registration
argument-hint: "<title>"
allowed-tools: mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-recall mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge mcp__plugin_ruflo-core_ruflo__memory_store mcp__plugin_ruflo-core_ruflo__memory_search Bash Read Write Edit Grep Glob
---
# Create ADR
Create a new Architecture Decision Record with the next sequential number, register it in the AgentDB graph, and link it to related ADRs.
## When to use
When a significant architectural decision needs to be recorded -- new technology adoption, API design choices, data model changes, infrastructure decisions, or any cross-cutting concern that affects multiple components.
## Steps
1. **Find next number** -- `Glob` for `docs/adr/ADR-*.md` and parse existing numbers to determine the next sequential ID (ADR-001, ADR-002, etc.). Create `docs/adr/` if it does not exist.
2. **Slugify title** -- Convert the title argument to a lowercase, hyphen-separated slug (e.g., "Use PostgreSQL for persistence" becomes `use-postgresql-for-persistence`).
3. **Create ADR file** -- `Write` the file at `docs/adr/ADR-NNN-<slug>.md` using the standard template:
```markdown
# ADR-NNN: <Title>
- **Status**: proposed
- **Date**: <today's date YYYY-MM-DD>
- **Deciders**: <leave blank for author to fill>
- **Tags**: <leave blank>
## Context
<!-- What is the issue that motivates this decision? -->
## Decision
<!-- What is the change that we are proposing? -->
## Consequences
### Positive
-
### Negative
-
### Neutral
-
## Links
```
4. **Store in AgentDB** -- Call `mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store` with:
- key: `mem:ADR-NNN`
- tier: `semantic`
- value: a JSON-encoded string: `{ "id": "ADR-NNN", "title": "<title>", "status": "proposed", "date": "<today>", "file": "docs/adr/ADR-NNN-<slug>.md" }`
5. **Find related ADRs** -- Call `mcp__plugin_ruflo-core_ruflo__memory_search` with the title as query in namespace `adr-patterns` to find related decisions. If matches are found, add them to the Links section and call `mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge` for each relationship with:
- sourceId: `mem:ADR-NNN`
- targetId: `mem:ADR-RELATED`
- relation: `depends-on`
6. **Store pattern** -- Call `mcp__plugin_ruflo-core_ruflo__memory_store` in namespace `adr-patterns` with key `ADR-NNN` and the title + context as value for future semantic search.
7. **Report** -- Output the created file path, ADR number, and any related ADRs found.
© ruvnet · MIT · ruvnet/ruflo