architecture-review について
architecture-reviewは、開発者向けにプロジェクト構造を点検し、改善するスキルです。依存関係と境界を把握してから、テストで検証しつつ段階的なリファクタリングを計画します。
主な機能
- 01ディレクトリ構造と依存関係の把握
- 02循環依存や肥大化したモジュールの特定
- 03問題の深刻度分類
- 04テストで検証する段階的な改修計画
- 05構造と依存管理に関する資料
活用シーン
- 01不慣れなコードベースの評価
- 02モジュール境界や依存関係の問題調査
- 03段階的な構造変更の計画
- 04不要コードの削除とモジュールの統合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/architecture-reviewを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/analysis-techniques.mdanti-rationalization.mdcleanup-strategies.mddependency-management.mdrefactoring-patterns.mdstructural-patterns.md詳細
アーキテクチャレビュー
プロジェクト構造を分析、監査し、改善します。
主要な原則
- 変更前に測定する — 変更を提案する前に構造を把握し、具体的な問題を特定します
- 明確な境界 — レイヤー（UI、ロジック、データ）を分離し、依存関係の方向を一貫させます
- 関連コードを近くに配置する — 関連するコードをまとめ、機能を見つけやすく、変更・削除しやすくします
- 段階的な移行 — フェーズごとにリファクタリングし、各ステップをテストで検証します
クイック評価
- 循環依存がない
- ディレクトリの命名と分類（機能別または種類別）に一貫性がある
- ファイル／モジュールごとに単一の責任があり、ファイルサイズが適切である（500 行未満）
- 外部依存が分離され、共有コードが適切に抽出されている
- 新しい開発者が、どの機能のコードも簡単に見つけられる
クイックスタートチェックリスト
- 現在の構造を把握する：ディレクトリツリー、依存関係グラフ、モジュールの境界
- 問題を特定する：循環依存、巨大なモジュール、漏れのある抽象化、深いネスト
- 深刻度を分類する：重大（開発を妨げる）、高（保守の負担）、中／低（使いづらさ）
- 移行計画とともに目標とする構造を提案する
- 段階的に実施し、各変更後にテストで検証する
参考資料
| 参考資料 | 説明 |
|---|---|
| analysis-techniques.md | 依存関係グラフ、複雑度の指標、コード分析 |
| refactoring-patterns.md | 安全なリファクタリング手法、移行戦略 |
| structural-patterns.md | さまざまなプロジェクトタイプのディレクトリ構造 |
| dependency-management.md | 循環依存、結合度、モジュールの境界 |
| cleanup-strategies.md | デッドコードの削除、統合、命名規則 |
| anti-rationalization.md | 鉄の掟、よくある正当化、アーキテクチャ規律のための危険信号を示す STOP リスト |
コメント
Markdown 対応