heal

heal はコミットの間に進むコードベースの劣化 — 複雑度の蓄積、Hotspot、重複 — を監視し、見つけた問題を次の Claude セッションが 1 コミット 1 修正で解消していく TODO に変えます。人間がポーリング役を務める必要はありません。

クイックスタート（5 分）

コンセプトを読む

なぜ heal なのか

AI コーディングエージェントは、依頼された次の変更を作るのは得意です。ただ、コードベースは裏で変わり続けます。複雑度が積み重なり、同じファイルが何度も触られ、重複したコードが少しずつ増える。エージェントはそうした長期的な変化を見ていません。外部シグナルが無ければ、それを追えるのは人間だけです。

heal がそのギャップを埋めます。git の post-commit フックが Critical / High の項目をコミット出力にそのまま表示し、heal status が同じ TODO リストを同梱の /heal-code-patch Claude スキルに渡して、1 コミット 1 修正で片付けていきます。

heal が観測するのは 3 つのファミリです:

• Code は常時オン — 複雑度、churn、重複、hotspot、凝集度。heal init 後にどのプロジェクトにも入る 7 メトリクスです。
• Test(オプトイン)は既存リポータの lcov.info を読み、カバレッジ未達の hot path とソースから取り残されたテストを表面化します。
• Docs(オプトイン)はペアになったドキュメントとソースを比較し、ドリフト、リンク切れ、孤立ページを検出します。

詳しくは 機能 を参照。