# OrbaOS™ doctrine — Post-Project World & OrbaLang

OrbaLang is a **language programme** within the **OrbaOS™** framework: portable, governed business logic for institutions that have moved beyond project-centric coordination.

> **Trademark:** OrbaOS™ is a trademark of **Rondanini Publishing Ltd**. Use the ™ symbol on first prominent mention in public-facing materials. OrbaLang is open source (MIT); the OrbaOS name and doctrine are protected brand assets.

## Post-Project World

The **Post-Project World** is the organisational shift OrbaOS addresses: when coordination becomes **infrastructure** rather than meetings, status reports, and human-mediated routing. Work moves in **flows** with explicit rules — not ad-hoc project phases.

OrbaLang encodes those rules in auditable source that transpiles to Python, TypeScript, Java, legacy validators, and more. It is the **Flow Layer** expression of governed decision logic: *when* a condition holds, *what* action is required, and *why* (audit metadata).

Further reading on the doctrine:

| Resource | URL |
| -------- | --- |
| OrbaOS™ home | https://orbaos.com/ |
| What is OrbaOS | https://orbaos.com/what-is-orbaos |
| About the methodology | https://orbaos.com/about |
| Resources & books | https://orbaos.com/resources |
| The Coordination Capital Doctrine | https://doctrine.orbaos.com/ |
| OrbaOS resources (books) | https://orbaos.com/resources |

## OrbaOS galaxy (`*.orbaos.com` + programme domains)

Programme surfaces are organised under **orbaos.com**, its subdomains, and affiliated programme domains. Canonical targets for OrbaLang adoption:

| Subdomain | Role | OrbaLang link |
| --------- | ---- | ------------- |
| [orbaos.com](https://orbaos.com/) | Doctrine hub — Post-Project World, CCR, framework | Parent programme |
| [doctrine.orbaos.com](https://doctrine.orbaos.com/) | The Coordination Capital Doctrine — board-level PDF access | Primary doctrine publication portal |
| [sovereignstate.orbaos.com](https://sovereignstate.orbaos.com/) | Sovereign State — governance simulation (Post-Project World) | Sibling programme; explore decision routing outside project hierarchies |
| [lang.orbaos.com](https://lang.orbaos.com/) | OrbaLang landing, docs, and playground | **This repository** — `/playground/` |
| [instruments.orbaos.com](https://instruments.orbaos.com/) | OrbaOS Instruments — coordination capital measurement | Complementary governance layer |
| [scenarioforge.orbaos.com](https://scenarioforge.orbaos.com/) | ScenarioForge — AI test-scenario design (self-hosted, your LLM) | Sibling product; pairs with governed policy + validation workflows |
| [frtb.orbaos.com](https://frtb.orbaos.com/) | FRTB SA / IMA — admissibility-controlled capital governance | Sibling product; replayable Merkle lineage for market-risk capital |
| [app.frtb.orbaos.com](https://app.frtb.orbaos.com/) | FRTB calculator app (authenticated) | Product UI behind credential |
| [globe.orbaos.com](https://globe.orbaos.com/) | OECD Pillar Two / GloBE — top-up tax governance | Sibling product; jurisdictional ETR + GIR export |
| [app.globe.orbaos.com](https://app.globe.orbaos.com/) | GloBE calculator app (authenticated) | Product UI behind credential |
| [languagefoundry.io](https://languagefoundry.io/) | Language Foundry — legacy transpiler (RPG, COBOL, SAS, ABAP → Java/Python) | Sibling programme; bulk migration complement to OrbaLang legacy emit |

**Pattern:** public doctrine + marketing at `{product}.orbaos.com`; credentialed SPA at `app.{product}.orbaos.com` (FRTB, GloBE). OrbaLang uses **`lang.orbaos.com`** with the playground at **`/playground/`** (no separate `play.` subdomain).

Local development mirrors OrbaLang paths:

```powershell
npm run site        # http://localhost:8346/  (landing)
npm run playground  # http://localhost:8347/playground/
```

DNS for `lang.orbaos.com` should CNAME to the GitHub Pages host. Sibling products under other `*.orbaos.com` hosts and **languagefoundry.io** run on their own infrastructure.

## Four layers (where OrbaLang fits)

OrbaOS is built on four foundational layers. OrbaLang primarily serves the **Flow** and **Intelligence** boundary:

1. **Values** — ethical and strategic commitments that guide autonomous systems  
2. **Flow** — how work moves; state transitions and routing rules → **OrbaLang rules & functions**  
3. **Intelligence** — AI that senses, decides, and coordinates using transpiled validators  
4. **Human** — judgment, ethics, and escalation tiers humans retain  

OrbaLang `rule` programs with `then: approval | deny | escalate` and `audit:` blocks align with tiered decision routing described in the OrbaOS framework.

## Creator attribution

**Luigi Pascal** (Luigi Pascal Rondanini) — creator of OrbaLang, author of the OrbaOS programme and the Post-Project World doctrine.

See [AUTHORS.md](../AUTHORS.md) for citation text and audit-field guidance.

## Audit metadata (programme credit)

In production `.orba` files, programme-level attribution:

```orba
audit:
  author: "OrbaOS / Luigi Pascal"
  version: "1.0"
  reason: "Policy purpose"
  programme: "OrbaOS"
  doctrine: "Post-Project World"
```

The `programme` and `doctrine` fields are documentary (lint may warn if unknown keys appear — use in comments or external metadata until schema formalises them in v0.4+).

## Contact

- OrbaOS programme: [contact@orbaos.com](mailto:contact@orbaos.com)  
- OrbaLang repository: https://github.com/luigipascal/Orbalang  
- Jira programme: **LANG** (epic LANG-1)