# Workflow Management

### Overview

In dex, your data projects are organized to support both collaborative development and reliable production workflows, all powered by Git-native version control.

This structure allows teams to safely iterate on their data pipelines while maintaining stable, production-grade automation.

### Core Concepts

The core concepts in dex follow a clear hierarchy:

```
Organization > Projects > Environments > Workspaces
```

Understanding each layer is key to managing your workflows effectively.

<table><thead><tr><th width="198.98828125">Concept</th><th>Description</th></tr></thead><tbody><tr><td>Organization</td><td>Represents your company’s account in dex. An <code>Organization</code> holds one or more <code>Projects</code> and acts as the top-level container for everything you build.</td></tr><tr><td>Project</td><td>A dex Project connects directly to a Git repository. It contains your data models, ELT configurations and connectors. Each <code>Project</code> defines its stack (e.g., BigQuery, Athena, PostgreSQL).</td></tr><tr><td>Environment</td><td>A stable, remote branch of your <code>Project’s</code> repository. All production-grade automations, orchestration, and pipelines run on <code>Environments</code>.</td></tr><tr><td>Workspace</td><td>A local/sandboxed copy of an <code>Environment</code>. It allows users to edit files, run commands, and experiment without impacting production workflows. Changes are only synced back when the user pushes them to Git.</td></tr></tbody></table>

### Switching Between Projects, Environments, and Workspaces

You can easily switch between different Projects, Environments, and Workspaces using the top navigation bar, as shown in the screenshot below. This allows you to move seamlessly between development, staging, and production environments or across different projects within your organization.

<figure><img src="/files/ltd2CI5U9uGNq0pbwODE" alt=""><figcaption></figcaption></figure>

To **create, edit, or delete** Projects, Environments, and Workspaces, go to the **side menu → Organization → Settings**. From there, you can manage your organization’s structure, link new repositories, configure environments for automation, and create workspaces for development.

{% hint style="info" %}
Learn more about repositories, version control, and Git integration [here](/lakehouse-platform/version-control-with-git.md)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dexlabs.io/lakehouse-platform/about-dex/workflow-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.