codebase-md: ツールはgitフックによるメンテナンスでCLAUDE.mdを自動生成します

ツール概要

codebase-mdは、Claude Codeを使用するプロジェクト向けにCLAUDE.mdファイルを自動生成および維持するPythonツールです。バージョン0.1.0はアルファ版で、MITライセンスです。

インストールと基本的な使い方

ASTサポート付きでインストール: pip install "codebase-md[ast]"

スキャンと生成: codebase scan .の後にcodebase generate .

生成される内容

このツールはCLAUDE.mdを以下の内容で作成します:

• アーキテクチャパターンの検出（モノリス、モノレポ、マイクロサービス、CLIなど）
• 命名スタイル、インポートパターン、tree-sitter ASTによるデザインパターンを含む自動検出された規約
• 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、tree-sitter AST統合、TF-IDFコンテキストランキングシステム、および354テストスイートを使用して構築されました。プロジェクト自身のCLAUDE.mdはcodebase-mdによって生成されました。