claude-md-optimizer
wrsmith108/claude-md-optimizerСкилл для Claude Code, который анализирует разросшиеся CLAUDE.md-файлы, разбивает их на суб-документы и переписывает основной файл без потери информации. Подходит для проектов с перегруженным системным контекстом.
Установка
git clone https://github.com/wrsmith108/claude-md-optimizer.gitREADME
claude-md-optimizer
Скилл для Claude Code, который оптимизирует разросшиеся файлы CLAUDE.md с помощью прогрессивного раскрытия. Анализирует уровни контента, обнаруживает ограничения шифрования, создаёт суб-документы и переписывает основной файл — без потери информации.
Проблема
Файлы CLAUDE.md растут органически по мере развития проекта. В них накапливаются руководства по устранению неполадок, команды деплоя, справочники по API и примеры конфигурации — наряду с основными правилами, нужными в каждой сессии. Поскольку CLAUDE.md загружается в каждый разговор Claude Code как системный контекст, разросшиеся файлы расходуют бюджет контекстного окна на контент, который нужен лишь изредка.
Проекты с 6+ месяцами разработки нередко достигают 800–1500+ строк.
Принцип работы
Скилл использует управляемый рабочий процесс из 6 фаз:
- Анализ — читает CLAUDE.md, разбирает секции, классифицирует каждую как Essential (каждая сессия), Reference (изредка) или Redundant (дублирует существующую документацию)
- Обнаружение ограничений — проверяет наличие шифрования git-crypt, SOPS или age; находит безопасные незашифрованные пути для суб-документов
- Планирование — представляет таблицу классификации: что остаётся встроенным, а что извлекается
- Проверка — пользователь утверждает план до внесения каких-либо изменений
- Выполнение — создаёт суб-документы (дословное извлечение), переписывает CLAUDE.md с таблицей суб-документации и ссылками прогрессивного раскрытия
- Валидация — сравнивает общий контент до и после для подтверждения нулевых потерь информации
Установка
Скопируйте скилл в директорию скиллов Claude Code:
git clone https://github.com/wrsmith108/claude-md-optimizer.git ~/.claude/skills/claude-md-optimizerПосле установки скилл автоматически доступен во всех сессиях Claude Code.
Использование
Запустите скилл, сказав любую из фраз:
- "optimize CLAUDE.md"
- "reduce CLAUDE.md size"
- "CLAUDE.md too long"
- "apply progressive disclosure to CLAUDE.md"
Скилл проанализирует файл и представит план на утверждение перед внесением изменений.
Структура скилла
claude-md-optimizer/
├── SKILL.md # Точка входа — фазы рабочего процесса, основные правила, краткий справочник
├── analysis.md # Методология и эвристики классификации контента
├── patterns.md # 8 паттернов прогрессивного раскрытия с деревом решений
├── constraints.md # Обнаружение шифрования, сканирование зависимостей CI, выбор безопасных путей
├── validation.md # Сравнение до/после, режимы отказа, процедура отката
└── README.md # Этот файл
Паттерны прогрессивного раскрытия
Скилл применяет следующие паттерны при переписывании CLAUDE.md:
| Паттерн | Сценарий использования |
|---|---|
| Sub-Documentation Table | Навигационный индекс в начале CLAUDE.md |
| Quick-Reference + Link | Одна основная команда + ссылка на полное руководство |
| Compressed Table + Link | Таблица поиска по устранению неполадок + ссылка на диагностику |
| Summary + Link | Краткое описание + ссылка на подробное руководство |
| Inline Essential | Контент, который должен оставаться встроенным (без извлечения) |
| Split | Основное резюме остаётся встроенным, детали извлекаются |
| Terse Agent Hint | Сжатие многострочных блоков кода до однострочных ссылок на команды |
Ключевые функции безопасности
- Управляемое решение — всегда представляет план и ждёт подтверждения пользователя перед изменением файлов
- Дословное извлечение — контент перемещается, но никогда не пересказывается и не перефразируется
- Учёт шифрования — обнаруживает git-crypt, SOPS и age; размещает суб-документы только в незашифрованных путях
- Защита от «курицы и яйца» — инструкции по разблокировке шифрования принудительно классифицируются как Essential и никогда не извлекаются
- Сканирование зависимостей CI — обнаруживает скрипты, которые сканируют CLAUDE.md через regex, и сохраняет совпадающий контент встроенным
- Валидация без потерь — проверяет общее количество строк после оптимизации; прерывает выполнение при обнаружении отсутствующего контента
Пример результатов
До: 850 строк
После: 320 строк (сокращение на 62%), 4 суб-документа (580 строк), нулевые потери информации
Когда НЕ использовать
Скилл откажется от оптимизации, если:
- CLAUDE.md содержит менее 300 строк
- Более 80% контента классифицировано как Essential
- Менее 200 строк доступно для извлечения
Лицензия
MIT