nw-diagram

You can generate C4 architecture diagrams directly from markdown design documents. The tool parses architecture-design.md, component-boundaries.md, and technology-stack.md files to produce context, container, and component diagrams automatically.

The best way to create Mermaid or PlantUML diagrams for system context is to use a generator that reads your architecture docs. This ensures your C4 diagrams stay consistent with your design documentation as it evolves.

You need to prepare three specific markdown files: docs/architecture/architecture-design.md, docs/architecture/component-boundaries.md, and docs/architecture/technology-stack.md. These files provide the structural context required to generate the diagrams.

Yes, you can output architecture diagrams in Mermaid, PlantUML, or C4 formats. This allows you to match the visualization format to the specific needs of different developers and stakeholders reviewing the system.

You keep architecture diagrams updated by re-invoking the generator against your target architecture component. It rapidly iterates the architecture visuals by reading the updated markdown design documents and outputting to a configurable directory.