- удалены скилл project-brief и контракт брифа; вместо них references/ project-facts.md — карта «что нужно проходу → где лежит» и таблица поразрядной деградации по документам - девять charter'ов, review-pipeline, task-pipeline и task-batch переписаны на пути канона; OpenSpec стал объявленной предпосылкой без ветки деградации - шаг синка документации переписан в построчный доклад, закрытие задачи — вызовом скилла av-dev-pm:tasks вместо строки-слота из CLAUDE.md - по находкам ревью: docs.py звал tasks.py из чужого каталога и выдавал его отказ окружения за дрейф; сверка миграций не видела рабочее дерево; плейсхолдер краснел вместо замечания; сверка capability проходила по совпадению с именем пакета; tasks.py не читал docs/.pm.json; скилл docs пересказывал канон в пяти местах
av-dev-skills
Личный маркетплейс плагинов и скилов для разработки — чтобы подключать их к
проектам по мере необходимости, а не держать в глобальном ~/.claude.
Подключение
Типичный способ — подключить плагин на уровне проекта, чтобы он был активен у
всех, кто открывает репозиторий. Флаг --scope project пишет прямо в
.claude/settings.json проекта (коммитится в репозиторий) — из интерактивной
сессии Claude Code:
/plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git --scope project
/plugin install av-dev-backlog@av-dev-skills --scope project
…или те же команды из терминала:
claude plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git --scope project
claude plugin install av-dev-backlog@av-dev-skills --scope project
Обе формы дописывают в .claude/settings.json ровно то, что можно внести и
руками — маркетплейс в extraKnownMarketplaces, плагин в enabledPlugins:
{
"extraKnownMarketplaces": {
"av-dev-skills": {
"source": {
"source": "git",
"url": "https://git.vakhrushev.me/av/dev-skills.git"
}
}
},
"enabledPlugins": {
"av-dev-backlog@av-dev-skills": true
}
}
При первом открытии проекта Claude Code попросит доверять воркспейсу; после
подтверждения маркетплейс и включённые плагины подгружаются автоматически. Ключ
включения — "<плагин>@<маркетплейс>": true.
Без --scope project те же команды пишут в user-конфиг — разовая установка
только себе, настройки проекта не трогаются:
/plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git
/plugin install av-dev-backlog@av-dev-skills
Плагины
- av-dev-backlog — ведение беклога задач как каталога markdown-файлов (одна
задача = один файл
<slug>.md+ строка в индексеREADME.md). Скиллbacklog: заведение задачи из диалога, разбор находок аудита/ревью, груминг, приоритизация, декомпозиция, штурм идей. Реализацией не занимается. Вызов:/av-dev-backlog:backlog. - av-dev-git — git-обвязка для личных проектов. Скилл
commit: сообщения коммитов в личном стиле (русский, опциональный scope-префикс, первая строка «что сделано», тело 1–3 пункта, без co-authored). Вызов:/av-dev-git:commit.
Соглашение об именах: имя плагина длинное с префиксом av-dev- (уникально в
маркетплейсе), имена скилов внутри — короткие. Вызов выходит вида
/av-dev-<плагин>:<скилл>.
Структура
.claude-plugin/marketplace.json — манифест маркетплейса
<plugin>/.claude-plugin/plugin.json — манифест плагина
<plugin>/skills/<skill>/SKILL.md — скилы плагина (авто-обнаружение)