The ArchToCode service allows for the automatic conversion of local folders and GitHub repositories into interactive Mermaid-based diagrams, helping developers maintain control over project structure in the era of intensive AI agent usage.

image

What Happened

A tool called ArchToCode has been developed, which uses artificial intelligence to automatically generate Mermaid diagrams based on existing software code. The service is capable of scanning local directories or connecting to GitHub repositories, creating visual maps of modules and data flows.

Context

In modern development, the "vibe coding" paradigm is actively evolving, where AI agents such as Cursor or Devin generate significant volumes of working code. However, this often leads to a loss of understanding of the global architecture and the accumulation of "architectural debt," where a developer cannot quickly assess the interconnections in the generated or modified code.

Why It Matters for the Industry

The tool addresses the problem of context loss when scaling AI-driven development. It allows for the creation of up-to-date visual documentation without the need for manual diagram updates, which is critical for ensuring architectural observability in modern development pipelines.

Why It Matters for Users

Developers can instantly understand the structure of complex legacy projects or new repositories. Additionally, the resulting diagrams can serve as additional visual context for the AI agents themselves, increasing the accuracy of their subsequent edits through a better understanding of the system topology.

What Is Not Yet Known / Limitations

There are questions regarding the scalability and accuracy of the tool when analyzing extremely large repositories.

Sources

Author

Look at AI, Editorial Team