skills.rest
mor-duongmh
mor-duongmhCOMMUNITY
Explore all skills by this author →
GitHub

generate-system-architecture

Generate an arc42-lite architecture document with an embedded Mermaid diagram from a ProjectModel.

3|Updated Apr 20, 2026
Search Tags:#architecture#documentation#mermaid#delta#arc42#codebase-sync#project-model
One-click install
npx skills add https://github.com/mor-duongmh/morkit-plugin --skill generate-system-architecture
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generate-system-architecture
Source: https://github.com/mor-duongmh/morkit-plugin/tree/main/plugins/morkit/skills/generate-system-architecture
Command: npx skills add https://github.com/mor-duongmh/morkit-plugin --skill generate-system-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Generate and maintain a concise system architecture document (arc42-lite) with an embedded Mermaid diagram from a ProjectModel, reducing manual drafting and drift.

Core Features & Use Cases

  • Generate a full arc42-lite system architecture from a ProjectModel, including components, layers, and interactions.
  • Render an embedded Mermaid diagram that visualizes layers and components, and groups unassigned items for clarity.
  • Create delta-ready outputs to apply architecture changes (CMP/LAY/INX/QG) and support codebase-driven sync workflows.

Quick Start

Provide a ProjectModel JSON and run the renderer to produce docs/system-architecture.md with the Mermaid diagram embedded.

Frequently Asked Questions about generate-system-architecture

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

FAQPage Schema
How do I generate an arc42 system architecture document with Mermaid diagrams?▼

To generate an arc42-lite system architecture document, provide a ProjectModel JSON and run the renderer to output a Markdown file with an embedded Mermaid diagram visualizing components and layers.

How do I keep my system architecture documentation in sync with my codebase?▼

To keep system architecture documentation in sync with your codebase, run the sync command to scan the codebase and propose Add or Deprecate changes as architecture deltas to the ProjectModel.

What is the best way to apply architecture deltas to a ProjectModel?▼

The best way to apply architecture deltas is using the update command, which processes CMP, LAY, INX, and QG changes and outputs updated Markdown documentation alongside a delta JSON file.

Can I visualize unassigned components in a Mermaid diagram automatically?▼

Yes, the Mermaid diagram generation automatically groups unassigned items from the ProjectModel to ensure visual clarity, rendering all layers and components within the Markdown architecture documentation.

Do I need a specific format to start drafting arc42-lite documentation?▼

You need a ProjectModel JSON containing your components, layers, and interactions to initialize the arc42-lite documentation and render the docs/system-architecture.md file.

What are the limitations of using arc42-lite for system architecture documentation?▼

The arc42-lite approach provides a concise architecture overview rather than full comprehensive documentation, relying entirely on the accuracy of the provided ProjectModel JSON for diagram and text generation.

Related Skills

Explore More Software Engineering Skills→
castrojocastrojo

architecture-diagram-specification

Generate JSON specifications for component, data flow, and deployment diagrams.

Community
Advanced
mor-duongmhmor-duongmh
3

generate-db-design

Render Mermaid ERD diagrams from a ProjectModel JSON into database design documents.

Community
Advanced
noelserdnanoelserdna

req-change

Manage requirements changes with bidirectional propagation across specification documents.

Community
Advanced
cassm199-mitacassm199-mita

mermaid

Generates Mermaid diagrams for technical documentation in markdown files.

Community
Intermediate