コア抽象
class EventBus {
subscribe (...) {
publish (...)
}
src/core/bus.ts:12プロダクト探偵ファイル
リポジトリ読解を、アーキテクチャ信号に変える。
arch-insight はリポジトリ文脈を行動可能な経路に圧縮し、コア抽象、依存関係、証拠、トレードオフ理由を明確化します。
クイックスタート
npx arch-insight install-release アーキテクチャレポート
- 設計思想
- コア抽象
- トレードオフ分析
- 要約
- 証拠
87%
トレードオフ
非同期な疎結合は
実装複雑性を高めるが
信頼性を確保できる。
証拠パス
src/flows/order.ts:87 主経路
クリティカルパス： src/flows/order.ts -> services/payment.ts -> core/bus.ts
同じリポジトリを何度も読み直さない。
Token の浪費
文脈圧縮がないため、再読コストが増え続ける。
反復作業
毎回ゼロから再分析し、再利用可能な構造がない。
浅い分析
目次レベルの要約では設計意図を説明できない。
スタイル不一致
出力が汎用テンプレート風で、チーム文体に合わない。
次アクション不足
結論が実装行動へつながりにくい。
目次要約ではなく、アーキテクチャ洞察へ。
広く浅い走査をやめ、意思決定がある経路に時間を集中します。
段階的 Intake
目的を定義してから重要ファイルへ絞り込む。
文脈パック最適化
フォルダ構造ではなく意図単位で証拠を整理。
Why から What へ
実装詳細より先に意思決定を説明。
証拠優先レポート
すべての主張をコードに遡及可能にする。
誠実なトレードオフ
利点・コスト・リスクを同時に記録。
ディレクトリツリー（ノイズ）
クリティカルパス（信号）
普段使うプラットフォームでそのまま使える。
- Codex
- Claude Code
- Gemini
- OpenCode
- Pi
- Kiro
- Cursor