# エージェントはアーキテクチャの痛点を指摘できるか

Canonical URL: https://bestskillsforclaude.com/ja/skills/improve-codebase-architecture
Language: ja
Skill: improve-codebase-architecture
Publisher: Matt Pocock (https://github.com/mattpocock)
Source: https://github.com/mattpocock/skills
License as stated by the publisher: MIT
Runtime: Claude Code and agents that support the skills CLI
Category: 実装とリリース
Last reviewed: 2026-08-05

候補は出せます。どれが重要かの判断は依然として人間側です。

## Short answer
improve-codebase-architecture スキルは、モジュールを単純化し深くする機会を探してコードベースを走査し、結果をレポートとして提示し、選ばれた候補だけをその後で掘り下げます。この順序が肝で、判断の前に書き換え始めることを拒む診断ツールです。

Best for: 急速に育ち、モジュール間に詳細が漏れ出しているコードベース。
Skip it if: 問題の所在をすでに把握できる規模のプロジェクト。

## What to remember
- 先にレポート、後で変更。この順序が安全に実行できる理由です。
- サブシステムに絞ってください。全体レポートは行動に移すには大きすぎます。
- 指摘は候補であって判定ではありません。チームだけが知る事情で間違っているものもあります。
- 根拠を検証したいときは grill-me と組み合わせます。

## 実務で何が変わるか
アーキテクチャの改善は技術的というより社会的な理由で止まります。どこから始めるか合意できず、結果として何も始まりません。理由付きの具体的な候補一覧は、その議論を意思決定に変えます。
レポート形式は、エージェントができる最も危険なこと、つまり目の前で複数モジュールを同時に書き換える行為も防ぎます。

## 期待に届かない点
見ているのはコードであって経緯ではありません。不格好な境界の一部は、どこにも書かれていない制約のために存在しており、スキルは自信をもって撤去を提案します。
長いレポートは範囲の膨張も招きます。候補を 1 つに絞る規律は完全に人間側の仕事です。

## Install and first run
1. mattpocock/skills から skills CLI 経由で MIT ライセンスで導入します。
2. リポジトリ全体ではなく 1 領域に対して実行し、レポートをレビュー可能な量に保ちます。
3. 候補を 1 つか 2 つ選びます。30 件の一覧は、何も選ばないための方法です。

## Questions
### コードを自動で書き換えますか
まずレポートを出し、選ばれた候補だけを掘り下げます。見つけ次第の書き換えはしません。

### どのくらいの規模まで扱えますか
サブシステム単位に絞ってください。リポジトリ全体のレポートは扱いきれないことが多いです。

### 誰が保守していますか
Matt Pocock が公開する skills リポジトリで、ライセンスは MIT です。

## Sources
- GitHub の mattpocock/skills: https://github.com/mattpocock/skills
- エージェントスキルのディレクトリ: https://skills.sh

## Other languages
- English: https://bestskillsforclaude.com/en/skills/improve-codebase-architecture
- Spanish: https://bestskillsforclaude.com/es/skills/improve-codebase-architecture
- Brazilian Portuguese: https://bestskillsforclaude.com/pt-br/skills/improve-codebase-architecture