/dr-optimize

Обзор

/dr-optimize проводит аудит всего фреймворка — навыки, агенты, команды, шаблоны — и выявляет проблемы: неиспользуемые компоненты, дубликаты, разросшиеся файлы, битые ссылки и устаревшие счётчики в документации. Генерирует отчёт с предложениями, ранжированными по уровню риска, и применяет только одобренные изменения.

Использование

/dr-optimize
/dr-optimize project
/dr-optimize framework

Когда запускать

• После каждых 5-10 завершённых задач
• После /dr-addskill для проверки пересечений
• Когда навыки перестают срабатывать или Claude забывает инструкции
• По рекомендации из /dr-archive Step 0.5 (рефлексия)

Что делает

1. Определение области — каталоги обнаружения клиентов в инициализированном проекте (.agents/, .claude/, .cursor/) и .datarim-runtime/ с раздельным учётом владельцев; либо, при явном аудите фреймворка, исходный репозиторий Datarim (изменения — через pull request). Глобальная область не поддерживается.
2. Полная инвентаризация — строит таблицу всех компонентов с размерами, описаниями и перекрёстными ссылками.
3. Граф зависимостей — связи: команды к агентам, агенты к навыкам, навыки к навыкам. Выявляет сиротские компоненты.
4. Обнаружение проблем — неиспользуемые компоненты, разросшиеся файлы (навыки: предупреждение от 300 строк, разделение от 400; агенты: от 120 и от 180), пересечение более 70%, устаревшие описания, битые ссылки, рассогласование счётчиков, превышение бюджета описаний, кандидаты на выборочную загрузку, дрейф Diátaxis-документации (мягкое предупреждение).
5. Отчёт — здоровье фреймворка (GOOD, NEEDS ATTENTION, BLOATED), количество проблем и предложения по уровню риска.
6. Согласование — спрашивает, какие предложения применить. Применяет только одобренные.
7. Синхронизация документации — обновляет AGENTS.md, README.md и dr-help.md, записывает изменения в datarim/history/evolution-log.md.

Аргументы

Необязательно. project (по умолчанию — инициализированный проект) или framework — явный аудит исходного репозитория Datarim. Глобальная/пользовательская область не поддерживается.

Результат

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

Пример сессии

> /dr-optimize

=== ОТЧЁТ ОБ ОПТИМИЗАЦИИ ===

Здоровье фреймворка: NEEDS ATTENTION
Компоненты: 19 агентов, 79 навыков, 28 команд, 28 Markdown-шаблонов и вспомогательные ресурсы
Всего строк: 4,250

Обнаружено проблем: 4
  1. [Low] Неиспользуемый навык: legacy-deploy.md
  2. [Low] Устаревшее описание: security.md
  3. [Medium] Дублирование: testing.md и qa.md (72%)
  4. [Medium] Рассогласование: README: 60 навыков, на диске: 67

Какие предложения применить? (all / none / 1,2,4)

Связанные команды

• /dr-addskill — добавление компонентов
• /dr-archive — Step 0.5 (рефлексия) может инициировать оптимизацию
• /dr-help — проверить список команд после изменений

Отчёт о результате

Перед сообщением человеку применяется Human Outcome Reporting. Объясняются изменение для пользователя, исходные условия, проверки и доказательства, а также открытые ограничения. Итог этапа не означает завершения всей задачи. Точные протоколы и технические записи сохраняются. Для повторного объяснения без продолжения работы — /dr-explain.