av
0eca206460
- скилл project-brief: бриф собирается из CLAUDE.md, архитектуры, Taskfile и конвенций и показывается человеку. Раньше единственная инструкция по его созданию лежала внутри шаблона, поэтому деградированный режим был не аварийным, а единственным: critical по основанию «нарушен инвариант» недостижим ни на одной задаче - rebase перенесён внутрь worktree задачи: прежняя форма падала на занятой ветке, и агент уводил весь батч в провалившиеся с ложной причиной - контракт брифа дополнен восемью слотами; проверен заполнением на обоих проектах, незаполнимых нет. Прецедент healthlog вынут из общего charter'а в бриф — там он вмёрз вместе с числами - шов: пайплайн задачу не закрывает и записи учёта не трогает, урожай отдаёт списком, правило остатка — ссылкой на av-dev-tasks - деградированный абзац во всех девяти проходах, вопрос 9 в ops, пространство имён в вызовах, раздел предпосылок
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 — скилы плагина (авто-обнаружение)