{"slug": "show-hn-arkviz-ai-generated-software-architecture-diagrams", "title": "Show HN: ArkViz – AI generated software architecture diagrams", "summary": "Bryant, founder of ArkViz, launched ArkViz, a product that uses AI to automatically generate software architecture diagrams from a codebase, built on the open-source LikeC4 architecture-as-code format. ArkViz pitches its structured model diagrams as deeper context for AI agents than text files like CLAUDE.md, AGENTS.md and ARCHITECTURE.md, and adds hosting, access control, scheduling automation, error handling and retries, logs and GitHub connectors that Bryant says users would otherwise have to build themselves with a harness like Claude Code.", "body_md": "Hi HN, I’m Bryant, founder of ArkViz ([https://arkviz.io](https://arkviz.io)). ArkViz is a product to automatically generate architecture diagrams from your codebase using AI.\n\nThe vision behind ArkViz is to supercharge both AI agents and humans by providing AI agents deeper relational context using structured model diagram formats, and by providing humans with a rich visual representation you can interact with, with features like zooming, panning, search, and show composing files.\n\nIn this new age of AI, you can generate a structured model diagram from your codebase in seconds, quicker and better than a human. Not only can the generated diagram be a visual documentation tool for humans, AI agents can also benefit from the context of a pre-generated architecture diagram that lives alongside a project’s codebase. This concept has already been proven by context files like CLAUDE.md, AGENTS.md, ARCHITECTURE.md living in the root of your repository.\n\nThe differentiator between ARCHITECTURE.md and ArkViz is that ArkViz generates a structured model diagram of the system, while ARCHITECTURE.md is broader in scope and purely text. ArkViz aims to be a supplement to ARCHITECTURE.md to provide deeper understanding like how components are connected, which components live inside other components, which files compose a component.\n\n—\n\nWhy ArkViz?\n\nSoftware engineering teams often create diagrams to aid in the documentation of their software systems. They are incredibly useful for onboarding new engineers and understanding projects. However, they take time to create and maintain, so are often non-existent or out of date. ArkViz automates the creation and maintenance of software architecture diagrams, seamlessly and securely.\n\nAI agents thrive when they have high quality context, including for architecture diagrams. However not all diagram formats out there are optimized for AI. A diagram showing connected systems and components can be represented in essentially 3 ways:\n\n1. Unstructured drawing / canvas format (e.g. draw.io, Excalidraw, Figma, LucidChart)\n\n```\n  - Quick to get started but hard to maintain.\n  - Good for brainstorming and whiteboarding\n  - The format carries no semantic meaning and is basically represented by pixels, shapes, and vectors. Positioning is stored\n  - Passing this to an AI agent as context has questionable value.\n```\n\n2. Structured diagramming formats (e.g. Mermaid, d2lang)\n\n```\n  - A level of abstraction higher than a 2D drawing canvas\n  - Good for quick isolated diagram, like on GitHub\n  - Represented by nodes and edges, nested hierarchies. Layout is generated\n  - Better for AI agents, although they have to piece together the context, and might get confused by an inconsistency like duplicate naming\n```\n\n3. Structured modeling formats (e.g. Structurizr, LikeC4, IcePanel).\n\n```\n  - These have an underlying data model and single source of truth\n  - High quality documentation, but hard to create and maintain\n  - Represented by entities and relationships. Layout can be richer, like zooming into a component and seeing what's inside\n  - Best for AI agents, since they have a single source of truth context\n```\n\nArkViz currently uses LikeC4 for its diagram format, a modern, popular, and open-source architecture-as-code format that supports interactive diagrams. AI agents will be more trained with this than a proprietary format.\nWhy not roll my own solution with something like Claude Code? While Claude Code is a powerful AI coding harness, ArkViz provides seamless features you'd rather not spend time building like hosting diagrams, access control, scheduling automation, handling errors and retries, logs, connectors to GitHub. Additionally, ArkViz has battle-tested, optimized multi-pass prompts, validators, and guardrails for the specific purpose of AI generated architecture diagrams.\n\nTake a look here: [https://arkviz.io](https://arkviz.io)! Feedback greatly appreciated on which features you care about, and whether you think the value proposition is there.\n\nComments URL: [https://news.ycombinator.com/item?id=50580994](https://news.ycombinator.com/item?id=50580994)\n\nPoints: 1\n\n# Comments: 0", "url": "https://wpnews.pro/news/show-hn-arkviz-ai-generated-software-architecture-diagrams", "canonical_source": "https://arkviz.io", "published_at": "2026-11-20 19:58:11+00:00", "updated_at": "2026-11-20 20:14:39.072570+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["ArkViz", "Bryant", "LikeC4", "Claude Code", "GitHub"], "also_reported_by": [], "takeaway": "ArkViz generates structured LikeC4 model diagrams from a codebase so AI agents get a single-source-of-truth architecture context rather than pixel-based canvas drawings or loosely structured Mermaid files.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/show-hn-arkviz-ai-generated-software-architecture-diagrams", "markdown": "https://wpnews.pro/news/show-hn-arkviz-ai-generated-software-architecture-diagrams.md", "text": "https://wpnews.pro/news/show-hn-arkviz-ai-generated-software-architecture-diagrams.txt", "jsonld": "https://wpnews.pro/news/show-hn-arkviz-ai-generated-software-architecture-diagrams.jsonld"}}