# Transitrix

> Transitrix: open methodology and tools to describe an enterprise as text — and let humans and machines run it together. An open research initiative: ArchiMate-grounded, business-layer, one formal model projected across every architectural layer, authored as plain YAML in git.

Most Transitrix source files are plain YAML: a `notation:` key naming the format and a `*.<notation>.transitrix.yaml` filename suffix — there is no `type:`/`version:` wrapper, no single-key `flow:` array, no `next:`-based sequencing. Document sources are the other shape: prose with `{{ … }}` directives, named `*.<kind>.ttrs`, where the middle segment is the document kind (`product.mrd.ttrs`) and never a notation.

Each notation has exactly one canonical extension — either `*.<short-name>.transitrix.yaml` or `*.<short-name>.ttrs` — and which one it takes is a property of that notation. `.ttrs` replaces the longer suffix in full for the notation that takes it; it is never appended to it, and no notation carries both. Do not invent a shape; use the canonical examples linked below.

## Canonical reference

- [DSL examples](https://transitrix.com/dsl-examples/): One minimal, schema-valid YAML example per notation Transitrix Studio ships (BPMN, goals, DGCA, capability maps, process maps, process blueprints, activity networks, activity cards, scenarios, applications, products, nested blocks, compliance impact) — copy-paste ready, all on one page.
- [Document source format `.ttrs`](https://transitrix.com/ttrs/): What a `.ttrs` source file contains, how `<basename>.<kind>.ttrs` is read, the `{{ … }}` directive language, and the reference states an implementation must distinguish. Links the normative specification, the reference implementation and the conformance fixture.
- [Notation specs](https://github.com/transitrix/methodology/tree/main/notations): The full specification for every notation, with larger worked examples per format.
- [JSON Schemas](https://github.com/transitrix/transitrix-studio/tree/main/schemas): Machine-checkable schemas backing the notations.

## Docs

- [Install & start](https://transitrix.com/install/): Install the Transitrix Studio editor extension, then scaffold a first file or a full architecture repository.
- [Methodology repository](https://github.com/transitrix/methodology): The methodology specification — open, MIT licensed.
- [Transitrix Studio repository](https://github.com/transitrix/transitrix-studio): The VS Code/JetBrains extension and CLI — the reference implementation. `transitrix validate <file>` checks any source file against its schema.
- [Worked example repository](https://github.com/transitrix/acme-corp): A complete, adopted Transitrix architecture repository to read end to end.

## Questions

- [What is Transitrix?](https://transitrix.com/what-is-transitrix/): Open methodology and tooling for describing an enterprise as text — a research initiative, not a SaaS product.
- [What does "enterprise as text" mean?](https://transitrix.com/enterprise-as-text/): The model is plain text under version control; diagrams and reports are generated views of it, not the source of truth.
- [How is this different from drawing tools?](https://transitrix.com/vs-drawing-tools/): Drawing tools store pictures; Transitrix stores validated, version-controlled text, and the picture is derived from it.
- [Which editor do I use?](https://transitrix.com/which-editor/): Transitrix Studio previews live in VS Code, Cursor, VSCodium, Windsurf and JetBrains IDEs; any editor plus the CLI works without it.
- [Is Transitrix open source?](https://transitrix.com/is-it-open-source/): The methodology and Transitrix Studio are public, MIT licensed; Transitrix DSM is a separate, not-yet-public product.
- [What can I model?](https://transitrix.com/what-can-i-model/): Processes, goals, capabilities, applications and behaviour — purpose-built notations, not one generic diagram type.
- [Do I need DSM to get started?](https://transitrix.com/do-i-need-dsm/): No — the open methodology and Transitrix Studio are enough to start modelling; DSM is a later addition.

## Optional

- [transitrix.com](https://transitrix.com/): Project home page — the stack, the thesis, and what's open today.
- [github.com/transitrix](https://github.com/transitrix): All public Transitrix repositories.