Skip to main content

Tutorial 7: Managing Large Multi-File Workspaces

In this tutorial, you will learn how to structure large architecture repositories by splitting models across files.


1. Directory Organization

Create a workspace with distinct files for each architectural domain:

my-enterprise/
├── capabilities.ea
├── applications.ea
└── infrastructure.ea

2. Cross-File Reference Pattern

capabilities.ea

capability cap_billing "Invoice & Billing Management" {
description "Core billing capability"
}

applications.ea

system sys_billing_engine "Cloud Billing Platform" {
relationships {
this realizes cap_billing "Realizes billing management"
}
}

infrastructure.ea

environment env_production "AWS Production" {
relationships {
this hosts sys_billing_engine
}
}

3. Unified Validation

Run the CLI on the entire folder:

nexusea validate ./my-enterprise

Scapius seamlessly aggregates and links all files across the workspace.