Skip to content

1. Design Principles

Kirill Kovtun edited this page Jun 11, 2026 · 1 revision

English | Русский

English

Design Principles

ORBIT is guided by a set of fundamental principles that influence every aspect of the language, its ecosystem, and future development.

1. Human and AI Friendly

ORBIT is designed to be equally accessible to humans and artificial intelligence systems.

Language constructs should be easy to read, write, generate, analyze, and understand without requiring complex interpretation.

2. Declarative First

ORBIT describes models rather than instructions.

Users define structures, relationships, processes, and timelines without specifying how they should be rendered or implemented.

3. Explicit and Deterministic

Every valid construct must have a single, unambiguous meaning.

ORBIT avoids hidden behavior, implicit assumptions, context-sensitive interpretation, and ambiguous grammar.

4. Model as Source of Truth

The model itself is the authoritative representation of information.

Visualizations, exports, generated artifacts, and other derived representations must always originate from the model definition.

5. Domain-Oriented Design

Different modeling domains require different concepts.

ORBIT provides domain-specific grammars that use terminology and constructs familiar to the problem being modeled rather than relying on generic visual primitives.

6. Validation by Design

Validation is a fundamental part of the language design.

ORBIT should help users identify, understand, and correct errors as early as possible through clear and actionable diagnostics.

7. Visual Independence

A model must remain independent from its visual representation.

Layout, positioning, styling, and rendering decisions should not affect the meaning of the model itself.

8. Extensibility Without Breaking Changes

The language must evolve without invalidating existing models.

New capabilities should be introduced in a way that preserves compatibility with previously defined specifications whenever possible.

9. Tool Independence

ORBIT models should remain portable across editors, renderers, platforms, and implementations.

No single application should be required to create, understand, or use an ORBIT model.

10. Consistency Over Brevity

Consistency is preferred over compact syntax.

ORBIT favors predictable and uniform language constructs over shortcuts, special cases, and syntax variations that increase complexity or ambiguity.

Русский

Принципы проектирования

ORBIT основывается на наборе фундаментальных принципов, которые определяют развитие языка, его экосистемы и будущих спецификаций.

1. Дружественность к человеку и ИИ

ORBIT должен быть одинаково удобен как для людей, так и для систем искусственного интеллекта.

Конструкции языка должны легко читаться, писаться, генерироваться, анализироваться и пониматься без сложной интерпретации.

2. Декларативность прежде всего

ORBIT описывает модели, а не инструкции.

Пользователь определяет структуры, связи, процессы и временные модели, не указывая способ их визуализации или реализации.

3. Явность и детерминированность

Каждая корректная конструкция должна иметь единственное и однозначное значение.

ORBIT избегает скрытого поведения, неявных предположений, контекстно-зависимой интерпретации и неоднозначной грамматики.

4. Модель как источник истины

Модель является авторитетным представлением информации.

Визуализации, экспорты, автоматически создаваемые артефакты и другие производные представления всегда должны основываться на определении модели.

5. Предметно-ориентированное проектирование

Разные области моделирования требуют разных понятий и терминов.

ORBIT предоставляет специализированные грамматики для различных предметных областей и использует знакомые пользователю концепции вместо универсальных графических примитивов.

6. Валидация как часть проектирования

Валидация является неотъемлемой частью языка.

ORBIT должен помогать пользователям находить, понимать и исправлять ошибки как можно раньше с помощью понятных и полезных диагностических сообщений.

7. Независимость от визуального представления

Модель должна оставаться независимой от способа её отображения.

Компоновка, расположение элементов, оформление и рендеринг не должны влиять на смысл модели.

8. Расширяемость без нарушения совместимости

Язык должен развиваться без нарушения работоспособности существующих моделей.

Новые возможности должны добавляться таким образом, чтобы сохранять совместимость с ранее определёнными спецификациями, когда это возможно.

9. Независимость от инструментов

Модели ORBIT должны оставаться переносимыми между редакторами, рендерерами, платформами и различными реализациями языка.

Для создания, понимания или использования модели не должно требоваться конкретное приложение.

10. Единообразие важнее краткости

Единообразие имеет больший приоритет, чем компактность синтаксиса.

ORBIT отдаёт предпочтение предсказуемым и согласованным конструкциям языка вместо сокращений, специальных случаев и альтернативных форм записи, которые увеличивают сложность или неоднозначность.

Clone this wiki locally