# コードベース設計改善 (improve-codebase-architecture)

> 浅いモジュールを深くするリファクタリング候補を探し、HTML レポートで可視化して、選んだ候補を問答で詰めます。

- カテゴリ: [アーキテクチャ改善](https://www.myskills.tools/ja/categories/architecture-tuning/)
- 提供元: コミュニティ · Matt Pocock
- リポジトリ: https://github.com/mattpocock/skills/tree/main/skills/engineering/improve-codebase-architecture (commit 7739eae)
- SKILL.md: https://github.com/mattpocock/skills/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md
- インストールコマンド: `npx skills add mattpocock/skills --skill improve-codebase-architecture`
- ライセンス: MIT
- 対応ツール: Claude Code, Codex, Copilot, Gemini CLI
- 権限: read-repo ✓, write-files ✓, shell ✓, network ✗
- 状態: スキャン済み
- ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。

## 基本ルール

スキャンの前に範囲を決め、最近よく変更されている箇所を優先します。

## 実行フェーズ

1. **範囲を決める** — ユーザーの指定があればそれに従い、なければ git log でホットスポットを探します。GLOSSARY.md と関連 ADR を先に読みます。
2. **摩擦を探す** — サブエージェントでコードを巡回し、浅いモジュールや局所性の欠如、シームからの漏れを探して削除テストで確かめます。
3. **HTML レポート作成** — OS の一時ディレクトリに自己完結型 HTML を書き出し、各候補に前後の図と推奨度を付け、最優先の候補を示します。
4. **候補を詰める** — 選ばれた候補について制約や依存、深化後の形を問答で詰め、GLOSSARY.md を更新し、必要なら ADR の記録を提案します。

## 権限の説明（SKILL.md より）

| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 一部で必要 | 一時ディレクトリの HTML レポートと、GLOSSARY.md・docs/adr/ の ADR のみを書き込みます。コード自体は変更しません。 |
| コマンド実行 | 一部で必要 | コミット履歴を見る git log と、レポートを開く open・xdg-open・start を実行します。 |
| 外部通信 | 不要 | スキル自体は通信しません。生成したレポートはブラウザで開くと CDN から Tailwind と Mermaid を読み込みます。 |

## SKILL.md のフロントマター（YAML）

```yaml
---
name: improve-codebase-architecture
description: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
disable-model-invocation: true
---
```

ホーム: https://www.myskills.tools/ja/ · URL: https://www.myskills.tools/ja/skills/improve-codebase-architecture/