Skip to content

Add karasu (text-based architecture DSL) to Architecture Diagram & C4 Model > Tools #150

Description

@kompiro

Suggested addition

I'd like to suggest adding karasu to the list.

Ready-to-paste entry (matches the section's existing format)

- [kompiro/karasu](https://github.com/kompiro/karasu) - Open-source text-based DSL for modeling the logical, physical, and organizational structure of a system in one language; C4-inspired, with drill-down navigation and SVG export

What it is / why it fits

karasu is an open-source, text-based DSL (and companion web app + VS Code extension) for describing software architecture as code. It is inspired by the C4 model and Structurizr but takes a distinct position:

  • Three-dimensional model in one language — logical (what/why), physical (how it deploys, via realizes), and organizational (who owns it, via owns) — so Conway's law / the inverse Conway maneuver can be discussed alongside the architecture itself.
  • Continuous drill-downsystem → service → domain → usecase → resource, instead of one all-at-once diagram (a deliberate cognitive-load design choice).
  • AI co-authorship.krs is plain text humans read/write, which also makes it bidirectional with AI generation.

The .krs / .krs.style language spec is at v1.0 (stable); the project is Apache-2.0 licensed.

Happy to open a PR instead if that's preferred — I opened an issue per the "meaningful description" guidance so you can place it however fits the list best. (Disclosure: I'm the author/maintainer.)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions