コードベースアーキテクチャの改善

AIのようにコードベースを探索し、アーキテクチャ上の摩擦を浮き彫りにし、テスタビリティ向上の機会を発見し、モジュール深化のリファクタリングをGitHub issueのRFCとして提案する。

深いモジュール（John Ousterhout著「A Philosophy of Software Design」）は、大きな実装を隠す小さなインターフェースを持つ。深いモジュールはよりテストしやすく、AIがナビゲートしやすく、内部ではなく境界でテストできるようになる。

プロセス

1. コードベースを探索する

Agent toolのsubagent_type=Exploreを使って、コードベースを自然にナビゲートする。厳格なヒューリスティクスに従わず、有機的に探索し、摩擦を感じた箇所を記録する：

• 1つの概念を理解するために多くの小さなファイルを行き来しなければならないのはどこか？
• インターフェースが実装とほぼ同じ複雑さを持つほど浅いモジュールはどこか？
• テスタビリティのためだけに純粋関数が抽出されているが、本当のバグはそれらの呼び出し方に潜んでいるのはどこか？
• 密結合なモジュールがモジュール間の接合部に統合リスクを生み出しているのはどこか？
• テストされていない、またはテストが難しい部分はどこか？

あなたが感じる摩擦こそがシグナルである。