78 lines
5.5 KiB
Markdown
78 lines
5.5 KiB
Markdown
|
# ADR-010: Anthropic dev-tooling formalization
|
|||
|
|
|
|||
|
|
- **Status:** Accepted
|
|||
|
|
- **Date:** 2026-05-18
|
|||
|
|
- **Deciders:** Дмитрий
|
|||
|
|
|
|||
|
|
## Context
|
|||
|
|
|
|||
|
|
Пять Anthropic-плагинов включены в `~/.claude/settings.json` `enabledPlugins`
|
|||
|
|
user-level, но не имеют номера в реестре Tooling §3.3 / PSR_v1 R10.1:
|
|||
|
|
`skill-creator`, `plugin-dev`, `hookify`, `claude-code-setup`, `context7`. Все пять
|
|||
|
|
из marketplace `anthropics/claude-plugins-official`.
|
|||
|
|
|
|||
|
|
Это повторение L1-паттерна «плагин фактически включён без формализации в правилах»:
|
|||
|
|
зафиксирован 2026-05-10 (UPM #31 / 21st #32 — обнаружены только когда заказчик
|
|||
|
|
спросил про конфликты), повторился 2026-05-13 (Sentry #34 / Redis #35 —
|
|||
|
|
формализованы retrospective в v1.92). Любое использование неформализованного
|
|||
|
|
плагина — байпас PSR_v1 R0.2/R10. Карта `docs/automation-graph.html` имеет
|
|||
|
|
соответствующие 5 узлов (iter7 audit-actualization 16.05.2026), но без номеров и
|
|||
|
|
без edge к governing-правилу; узел `hookify_plugin` несёт незакрытый 🔴-конфликт
|
|||
|
|
`hookify_plugin ↔ hk_pre_claude` (плагин hookify может перезаписать существующие
|
|||
|
|
хуки в `settings.json`).
|
|||
|
|
|
|||
|
|
Аудит «мозга» (discovery-interview SYSTEM-режим, 2026-05-18) вскрыл долг; заказчик
|
|||
|
|
выбрал формализовать все 5, предварительно закрыв риски.
|
|||
|
|
|
|||
|
|
## Decision
|
|||
|
|
|
|||
|
|
Пять плагинов формализуются как позиции #56–#60 реестра Tooling в **двух новых
|
|||
|
|
off-phase подкатегориях** (семантика разная — одна категория запутала бы правила):
|
|||
|
|
|
|||
|
|
- **authoring-tooling** — создание Claude-артефактов: #56 skill-creator,
|
|||
|
|
#57 plugin-dev, #58 hookify.
|
|||
|
|
- **dev-support** — поддержка/документация Claude-разработки: #59 claude-code-setup,
|
|||
|
|
#60 context7.
|
|||
|
|
|
|||
|
|
Граничные правила (locked):
|
|||
|
|
|
|||
|
|
1. **hookify (#58)** — вызов только по явному `/hookify`, не проактивно. Перед
|
|||
|
|
генерацией хука — обязательный pre-check на коллизию с уже-зарегистрированными
|
|||
|
|
хуками в `~/.claude/settings.json`; перезапись 6-компонентной economy/
|
|||
|
|
skill-discipline архитектуры запрещена. Это закрывает 🔴-конфликт
|
|||
|
|
`hookify_plugin ↔ hk_pre_claude` (🔴 → 🟢).
|
|||
|
|
2. **skill-creator (#56) ↔ plugin-dev:skill-development (#57)** — skill-creator для
|
|||
|
|
standalone проектных скилов; plugin-dev:skill-development — для скилов внутри
|
|||
|
|
разрабатываемого marketplace-плагина. Вендоренные и self-authored скилы
|
|||
|
|
модифицируются прямым Edit, не через skill-creator.
|
|||
|
|
3. **context7 (#60) ↔ WebFetch ↔ WebSearch** — context7 первый выбор для
|
|||
|
|
документации известной библиотеки; WebFetch — конкретный URL; WebSearch — поиск
|
|||
|
|
без URL.
|
|||
|
|
4. **claude-code-setup (#59)** — read-only анализатор; рекомендации фильтруются
|
|||
|
|
через R0/R10.1, ничего не устанавливается без явного согласования.
|
|||
|
|
|
|||
|
|
Обе подкатегории — не UI → вне фильтров PSR_v1 R6.0/R6.1 и R14 pipeline; регулируются
|
|||
|
|
R10.1 Блок 1 как infrastructure (по образцу claude-md-management #33).
|
|||
|
|
|
|||
|
|
ADR обязателен (не retrospective-без-ADR как Sentry/Redis #34/#35): здесь 5 позиций
|
|||
|
|
и 2 новые подкатегории — decision-grain выше порога.
|
|||
|
|
|
|||
|
|
## Consequences
|
|||
|
|
|
|||
|
|
- Положительно: L1-долг для 5 Anthropic-плагинов закрыт — использование больше не
|
|||
|
|
байпас R0.2/R10; 🔴-конфликт hookify закрыт правилом (🔴 → 🟢, классификация карты
|
|||
|
|
🔴1/⚫3/🟢7 → 🔴0/⚫3/🟢8); карта получает edge к governing-правилу для 5 узлов.
|
|||
|
|
- Отрицательно: реестр Tooling растёт 55 → 60; число off-phase подкатегорий 12 → 14.
|
|||
|
|
- Риск: эти 5 плагинов включены user-level — влияют на все проекты машины;
|
|||
|
|
формализация в Лидерра-нормативке другие проекты не ломает (они её не читают) —
|
|||
|
|
это не риск, а ограничение области действия.
|
|||
|
|
- Defer: изменение `enabledPlugins` (выключение плагинов) — отвергнуто заказчиком в
|
|||
|
|
пользу формализации; не выполняется.
|
|||
|
|
|
|||
|
|
## Enforcement
|
|||
|
|
|
|||
|
|
None — формализация декларативная (реестр + границы в R10.1 / Pravila §13.2).
|
|||
|
|
hookify pre-check на коллизию хуков — поведенческое правило, проверяется code review,
|
|||
|
|
не автоматическим гейтом. Границы #56–#60 зафиксированы в Tooling §4.31–§4.32 и
|
|||
|
|
PSR_v1 R10.1 Блок 1.
|