update-ai-setup

name	update-ai-setup
description	Сканирует AI-файлы проекта и обновляет реестр docs/ai-setup.md с актуальными данными. Используй для синхронизации реестра после добавления/удаления скиллов, паттернов или конфигов. Не используй для создания реестра с нуля — для этого создай docs/ai-setup.md вручную.
allowed-tools	Read Write Edit Glob Grep Bash(wc*) Bash(ls*)
agent	agents/auditor.md
context	fork

/update-ai-setup — Обновление реестра AI-конфигурации

Автоматическое обновление docs/ai-setup.md — реестра всех AI-паттернов, скиллов и конфигурационных файлов проекта. Сканирует реальное состояние файлов и синхронизирует реестр.

Перед началом

Прочитай .claude/qa_agent.md и .claude/agents/auditor.md.

Когда использовать

• После добавления/удаления скилла
• После изменения qa_agent.md, agents/*.md или CLAUDE.md
• После добавления/удаления анти-паттернов
• После изменения плагинов в .claude/settings.json
• После изменения MCP серверов в .mcp.json
• Периодическая проверка актуальности реестра

Входные данные

Не требуются. Скилл работает автоматически на основе текущего состояния файлов.

Алгоритм

Verbosity Protocol

Structured Output Priority: Весь analysis идёт в артефакт (MD/HTML), не в чат.

Chat output (ограничения):

• Brief Summary: max 5 строк (что нашли, сколько, итог)
• Findings table: max 15 строк (топ по severity)
• Полный отчёт: 📊 Полный отчёт: {path} + открыть файл

Iterative steps: Не выводить прогресс по каждому файлу. Checkpoint только при:

• Phase transition (Фаза N → Фаза N+1)
• Предупреждение обнаружено
• Завершение (SKILL COMPLETE)

Tools first:

• Grep → table → report, без "Now I will grep..."
• Read → analyze → report, без "The file shows..."

Post-Check: Inline перед SKILL COMPLETE (5-7 строк checklist), не отдельный файл.

Шаг 1: Чтение текущего реестра

Прочитай docs/ai-setup.md. Если файл не существует:

⚠️ WARNING: docs/ai-setup.md не найден — создаю новый файл.

Скилл создаёт пустой реестр на основе шаблона .claude/skills/init-skill/references/skill-template.md и продолжает сканирование.

Запомни текущие данные: список файлов, строки, количество паттернов, скиллов, анти-паттернов.

Шаг 2: Сканирование файлов

Выполни Glob по всем AI-файлам:

Обязательные:
  - CLAUDE.md
  - .claude/qa_agent.md
  - .claude/settings.json
  - .mcp.json
  - .claude/skills/*/SKILL.md
  - .claude/qa-antipatterns/_index.md
  - .claude/qa-antipatterns/*/*.md
  - .claude/skills/*/references/*
  - docs/ai-files-handbook.md
  - docs/ai-setup.md

Для каждого найденного файла подсчитай строки через wc -l.

Шаг 2b: Сканирование плагинов и MCP серверов

1. Прочитай .claude/settings.json → извлеки ключи из enabledPlugins
2. Прочитай .mcp.json → извлеки ключи из mcpServers
3. Сравни с таблицами "Плагины" и "MCP серверы" в docs/ai-setup.md
4. Дельта: добавить новые / удалить отсутствующие / обновить изменённые строки

Шаг 3: Обнаружение дельты

Сравни результаты сканирования с текущим реестром:

Проверка	Действие
Новый файл (есть на диске, нет в реестре)	Добавить в соответствующую таблицу
Удалённый файл (есть в реестре, нет на диске)	Удалить из таблицы
Изменение размера > 20%	Обновить счётчик строк
Новый скилл	Добавить в таблицу скиллов + проверить CLAUDE.md
Новый анти-паттерн	Добавить в таблицу анти-паттернов

Если дельты нет — сообщи пользователю и заверши:

✅ Реестр актуален. Изменений не обнаружено.

Шаг 4: Обновление документа

Обнови docs/ai-setup.md:

1. Диаграмма архитектуры — обновить счётчики строк в слоях
2. Таблицы инвентаризации — добавить/удалить строки, обновить счётчики
3. Каталог паттернов — добавить новые паттерны (если обнаружены), обновить ссылки

Формат записи Changelog:

| YYYY-MM-DD | [Описание: что добавлено/удалено/обновлено] |

Шаг 5: Валидация и показ diff

Перед сохранением:

1. Проверь Quality Gates (см. ниже)
2. Покажи пользователю список изменений:

📊 DELTA REPORT
├─ Добавлено: [N файлов/паттернов]
├─ Удалено: [N файлов/паттернов]
├─ Обновлено: [N счётчиков строк]
├─ Health Metrics: [обновлено / нет данных]
└─ Changelog: [краткое описание записи]

3. Сохрани обновлённый docs/ai-setup.md

Формат вывода

✅ SKILL COMPLETE: /update-ai-setup
├─ Артефакты: docs/ai-setup.md
├─ Дельта: [+N добавлено, -N удалено, ~N обновлено | "нет изменений"]
├─ Quality Gates: PASS
└─ Changelog: [краткое описание]

Quality Gates

• Все пути в документе существуют на диске (проверить Glob)
• Счётчики строк совпадают с wc -l
• Нет placeholder'ов [xxx] в финальном документе
• Changelog содержит новую запись с текущей датой
• Количество скиллов в реестре = количеству .claude/skills/*/SKILL.md
• Количество анти-паттернов в реестре = количеству .claude/qa-antipatterns/*/*.md (файлы в подпапках, без _index.md)
• Количество плагинов в таблице = количеству ключей в settings.json → enabledPlugins
• Количество MCP серверов в таблице = количеству ключей в .mcp.json → mcpServers

Связанные файлы

• Реестр: docs/ai-setup.md
• Гайд: docs/ai-files-handbook.md
• Шаблон skill: .claude/skills/init-skill/references/skill-template.md