From arch-review
Analyzes any codebase's architecture with 6 specialist agents (perf/scale, reliability, security, ops/DX, data/deps + Codex cross-review). Agents debate risks, fragile spots, improvements for audits/refactors.
npx claudepluginhub sean-sunagaku/claude-code-plugin --plugin arch-reviewThis skill uses the workspace's default tool permissions.
6 つの専門エージェントがコードベースを多角的に分析し、議論を通じてリスクと改善点を洗い出す。
Performs architecture reviews across 7 dimensions (structural, scalability, enterprise readiness, performance, security, ops, data) with scored reports and recommendations. For design critiques and system audits.
Reviews code for quality issues: architecture conformance, anti-patterns, performance, maintainability. Read-only analysis, never modifies code.
Evaluates code architecture for maintainability and structural issues before they become technical debt. Use for PR reviews with changes, refactoring planning, new feature evaluation, debt assessment.
Share bugs, ideas, or general feedback.
6 つの専門エージェントがコードベースを多角的に分析し、議論を通じてリスクと改善点を洗い出す。
Step 1: ヒアリング(対象ディレクトリ・重点観点の確認)
Step 2: コードベース偵察(リーダーがプロジェクト構造を把握)
Step 3: チーム起動 & 並列分析(Round 1 - 6体が独立に分析)
Step 4: クロスレビュー議論(Round 2-3 - 反論・補足・合意形成)
Step 5: レポート統合 & 出力
Step 6: クリーンアップ
以下を確認する(不明ならユーザーに質問):
リーダー(メインの Claude)がプロジェクト構造を走査する:
ls でトップレベル構造を確認package.json, tsconfig.json, Cargo.toml, go.mod 等の設定ファイルを Readプロジェクトコンテキスト:
- プロジェクト名: {name}
- 言語/フレームワーク: {tech stack}
- ディレクトリ構成: {tree overview}
- 主要エントリポイント: {paths}
- 設定ファイル: {paths}
- テストの有無: {yes/no, framework}
- 特記事項: {CLAUDE.md や README から得た情報}
TeamCreate で arch-review チームを作成。6 体のエージェントを 1 つのメッセージで並列に TaskCreate で起動する。
| # | name | 担当 | subagent_type | 分析対象 |
|---|---|---|---|---|
| 1 | perf-scale-analyst | パフォーマンス + スケーラビリティ | arch-review:perf-scale-analyst | ボトルネック、レイテンシ、密結合、スケール限界 |
| 2 | reliability-analyst | 信頼性 + デグレ耐性 | arch-review:reliability-analyst | テスト不足、型安全性、壊れやすい箇所、エラーハンドリング |
| 3 | security-analyst | セキュリティ | arch-review:security-analyst | インジェクション、認証/認可、機密情報、入力検証 |
| 4 | ops-dx-analyst | 運用 + DX | arch-review:ops-dx-analyst | ログ、可観測性、デバッグ性、コード規約、命名 |
| 5 | data-deps-analyst | データ整合性 + 依存関係 | arch-review:data-deps-analyst | 状態管理、キャッシュ、ライブラリ版管理、EOL 依存 |
| 6 | codex-reviewer | クロスカットレビュー | general-purpose | Codex CLI で横断分析、見落とし検出 |
TaskCreate で 8 つのタスクを作成:
perf-scale-analyst: パフォーマンス + スケーラビリティ分析(依存なし)reliability-analyst: 信頼性 + デグレ耐性分析(依存なし)security-analyst: セキュリティ分析(依存なし)ops-dx-analyst: 運用 + DX 分析(依存なし)data-deps-analyst: データ整合性 + 依存関係分析(依存なし)codex-reviewer: Codex によるクロスカット分析(依存なし)addBlockedBy: ["1","2","3","4","5","6"])addBlockedBy: ["7"])subagent_type: "arch-review:{role-name}"
team_name: "arch-review"
mode: "bypassPermissions"
run_in_background: true
subagent_type: "general-purpose"
team_name: "arch-review"
mode: "bypassPermissions"
run_in_background: true
{project-dir}/docs/.arch-review-workspace/{role-name}-findings.md全エージェントの Round 1 分析が完了したら、クロスレビューを開始する。
各エージェントに他の全 findings ファイルのパスを SendMessage で通知し、以下を指示:
全エージェントの議論が収束したら、リーダーが統合レポートを作成する。
docs/arch-review-YYYY-MM-DD.md に Write で保存rm -rf docs/.arch-review-workspace/shutdown_request を SendMessage で送信TeamDelete で arch-review チームを削除