codebase-md: Инструмент автоматически генерирует CLAUDE.md с поддержкой через git-хуки

Обзор инструмента

codebase-md — это инструмент на Python, который автоматически генерирует и поддерживает файлы CLAUDE.md для проектов, использующих Claude Code. Версия 0.1.0 находится в альфа-стадии и распространяется по лицензии MIT.

Установка и базовое использование

Установите с поддержкой AST: pip install "codebase-md[ast]"

Сканирование и генерация: codebase scan ., затем codebase generate .

Генерируемое содержимое

Инструмент создаёт CLAUDE.md со следующим:

• Обнаружение архитектурных паттернов (монолит, монорепозиторий, микросервис, CLI и т.д.)
• Автоматически определяемые соглашения, включая стиль именования, паттерны импорта и паттерны проектирования через дерево AST tree-sitter
• Проверка состояния зависимостей в реестрах PyPI/npm
• Аналитика git с анализом контрибьюторов и выявлением наиболее активных файлов
• Интеллектуальная маршрутизация контекста для Claude, чтобы запрашивать соответствующие части кодовой базы

Дополнительные возможности

Генерирует конфигурационные файлы для других инструментов: .cursorrules, AGENTS.md, codex.md и .windsurfrules на основе того же сканирования.

Установка git-хуков: codebase hooks install . автоматически поддерживает сгенерированные файлы в актуальном состоянии.

Аналитика зависимостей

Включает команду deps для управления зависимостями:

• codebase deps . — Полная панель состояния
• codebase deps . --offline — Только локальная оценка, без запросов к реестрам
• codebase deps . --upgrade fastapi — План обновления для конкретных пакетов

Система зависимостей проверяет зафиксированные версии в реестрах и помечает устаревшие пакеты, плохо поддерживаемые пакеты и критические изменения в путях обновления.

Детали разработки

Инструмент был создан с использованием Claude Code для архитектурных решений, интеграции дерева AST tree-sitter, системы ранжирования контекста TF-IDF и набора из 354 тестов. Собственный CLAUDE.md проекта был сгенерирован с помощью codebase-md.