karasu

A text-based DSL for describing the logical, physical, and organizational dimensions of a system in one language — built to co-design teams and architecture together.

Try it in your browser Read the guides Syntax reference GitHub DeepWiki

What is karasu?

karasu (鴉) is a text-based DSL for architecture. In one .krs language you describe a system’s three dimensions — the logical structure (services and domains and how they relate), the physical structure (the deployment units that realize them), and the organizational structure (the teams that own them) — so teams and architecture can be co-designed together. karasu renders each dimension as an SVG diagram you can drill down into.

Guides — designing service and team boundaries, onboarding, evolution.
Reference — the .krs / .krs.style syntax, tags, and annotations.
Concepts — the design philosophy behind karasu.

Browse the codebase as an AI-generated, conversational wiki on DeepWiki: