Core Abstraction
class EventBus {
subscribe (...) {
publish (...)
}
src/core/bus.ts:12Product Detective File
Turn every repository read into architecture signal.
arch-insight compresses repository context into actionable paths, mapping core abstractions, dependencies, evidence, and trade-off rationale.
Quick Start
npx arch-insight install-release Architecture Report
- Design Rationale
- Core Abstraction
- Trade-off Analysis
- Summary
- Evidence
87%
Trade-offs
Async decoupling brings
higher implementation complexity
to preserve reliability.
Evidence Path
src/flows/order.ts:87 Main flow
Critical Path： src/flows/order.ts -> services/payment.ts -> core/bus.ts
Stop rereading the same repository over and over.
Token Waste
No context compression means repeated cost on every pass.
Repeated Work
Each analysis restarts from zero with no reusable structure.
Shallow Analysis
Directory-level summaries cannot explain architectural intent.
Style Mismatch
Output sounds generic, not like your engineering organization.
No Guidance
Findings do not convert cleanly into next actions.
Architecture insight, not directory summaries.
Replace broad traversal with path signals and spend time where decisions actually live.
Phased Intake
Set the goal first, then narrow into high-value files.
Focused Context Packs
Group evidence by intent, not folder hierarchy.
Why Before What
Explain decisions before implementation details.
Evidence-First Reports
Every claim maps back to source code.
Honest Trade-offs
Document benefits, costs, and risk together.
Directory Tree (Noise)
Critical Path (Signal)
Work on platforms you already use.
- Codex
- Claude Code
- Gemini
- OpenCode
- Pi
- Kiro
- Cursor
Make repository comprehension a repeatable workflow.
Start with one command and keep shipping structured insight.
CLI
npx arch-insight install-release