
karasu
What is karasu?
Section titled “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.
Four registers label what you draw: a tag says what an element is and an annotation says what stage it is at (both are karasu’s own vocabulary), a facet says which sets it belongs to (you declare them), and a boundary says how to group it in a view. See Vocabulary registers and the Grouping & membership examples.
- Guides — designing service and team boundaries, onboarding, evolution.
- Reverse-engineer a repository: have your coding agent build a model of an existing codebase.
- Reference — the
.krs/.krs.stylesyntax, tags, and annotations. - Concepts — the design philosophy behind karasu.
Browse the codebase as an AI-generated, conversational wiki on DeepWiki:
© 2026 Hiroki Kondo · Licensed underApache-2.0