architecture-map

Generate Mermaid architecture diagrams from Node.js/TypeScript codebases.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/extremecoder-rgb/GitLyzr --skill architecture-map-extremecoder-rgb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-map
Source: https://github.com/extremecoder-rgb/GitLyzr/tree/main/skills/architecture-map
Command: npx skills add https://github.com/extremecoder-rgb/GitLyzr --skill architecture-map-extremecoder-rgb

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about architecture-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Mermaid diagram from a TypeScript codebase?

You can generate a Mermaid diagram by analyzing a TypeScript codebase's entry points, module structures, and import graphs to automatically produce visual architecture diagrams of module relationships and system components.

How do I detect circular dependencies in a Node.js project?

Detecting circular dependencies in a Node.js project involves analyzing the import graph and module structures to identify circular import chains, report layer violations, and visualize these architectural issues within a generated diagram.

Does this architecture mapping approach support framework-specific patterns like NestJS and Next.js?

Yes, this architecture mapping approach supports framework-specific patterns for NestJS, Next.js, Express, and Fastify by parsing their unique conventions to build a complete and accurate dependency graph for your codebase.

Can I assess codebase health by identifying layer violations in TypeScript?

Yes, you can assess codebase health by identifying presentation, application, domain, and infrastructure layers to report violations, detect circular dependencies, and provide metrics on coupling and orphan modules.

What is the best way to visualize module relationships and external services in Node.js?

The best way to visualize module relationships and external services in Node.js is to generate Mermaid diagrams that illustrate system components by parsing import graphs, tsconfig path aliases, and framework-specific patterns.

Do I need to manually specify entry points for code analysis?

No, you do not need to manually specify entry points for code analysis because the process automatically locates main files such as the package.json main field, src/index.ts, or framework-specific sources.