What problem does it solve?
Understanding the structure of a Node.js/TypeScript codebase is hard, especially when layers, dependencies, and framework conventions intertwine, making it difficult to visualize architecture, spot violations, and communicate design decisions.
Core Features & Use Cases
- Entry Point Detection: Automatically locate the main file(s) such as
package.json main, src/index.ts, or framework‑specific sources.
- Module & Dependency Mapping: Parse imports, tsconfig path aliases, and framework patterns (Express, NestJS, Next.js, Fastify) to build a complete dependency graph.
- Layer & Circular‑Dependency Analysis: Identify presentation, application, domain, and infrastructure layers, report violations, and detect circular import chains.
- Mermaid Diagram Generation: Produce ready‑to‑use Mermaid diagrams that illustrate module relationships, system components, and external services.
- Health Assessment: Provide metrics on coupling, layer discipline, circular dependencies, god modules, and orphan modules.
Quick Start
Ask the skill to create an architecture diagram for the current repository.