← 一覧へ
✨ コードを良くするCC / Codex 両対応難易度: 中級
コードベースのアーキテクチャ改善 improve-codebase-architecture
コードの構造を深く美しく改善しよう
これは何？
これはコードの構造を改善するためのツールです。コードベースを分析して、テストしやすくAIが理解しやすい深いモジュール構造にするための提案をしてくれます。プロジェクトのドメインモデルに基づいた専門的なアドバイスが得られます。
これでできること
- コードベース全体のアーキテクチャ上の問題点を発見できます
- 改善案を視覚的なHTMLレポートで確認できます
- 選んだ改善点について詳細に設計を詰められます
- ドメイン用語やアーキテクチャ用語を統一して提案してくれます
- 既存の設計決定(ADR)と矛盾しない提案をしてくれます
こんな時に便利
大規模なリファクタリングを始める前に問題点を把握したい時
コードのテスト容易性を向上させたい時
新しいメンバーがコードベースを理解しやすくしたい時
AIがコードを理解しやすい構造にしたい時
モジュール間の依存関係を整理したい時
使い方
まず/codebase-designスキルでアーキテクチャ用語を確認しましょう。次にこのスキルを実行すると、コードベースを分析して改善案をHTMLレポートで表示します。気になる改善点を選ぶと、/grillingスキルで詳細な設計検討が始まります。
使用例（こう頼んでみよう）
このプロジェクトのアーキテクチャ改善点を分析してください注文処理モジュールの構造改善案を提案してくださいテストが難しい部分のアーキテクチャ改善案を教えてください必要なもの
- CONTEXT.mdにドメイン用語が定義されていること
- docs/adr/にアーキテクチャ決定記録(ADR)があるとより正確な提案が可能
導入方法
いちばん簡単（AIに頼む）
次のスキルを入れて: https://github.com/mattpocock/skills/tree/main/skills/engineering/improve-codebase-architecture手動で置く
Claude Code →
~/.claude/skills/improve-codebase-architecture/Codex →
~/.agents/skills/improve-codebase-architecture/使いこなしのコツ
- 改善案を検討する時は必ずCONTEXT.mdの用語を使いましょう
- HTMLレポートのbefore/after図をよく見ると理解が深まります
- 既存のADRと矛盾する提案は慎重に検討しましょう