> For the complete documentation index, see [llms.txt](https://docs.zaia.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zaia.app/squads/creating-squads.md).

# Creating Squads

This guide focuses on the **practical steps and management actions** involved in creating and maintaining Squads inside Zaia Endless.

If you’re looking for conceptual explanations about what Squads are and when to use each mode, refer to the previous article.

***

### Step 1: Create a Squad

1. Go to **Builder → Squads**
2. Click **New Squad**
3. Choose a **Management Mode**:
   * **Hierarchical**
   * **Horizontal**
4. Define a **Name**
5. Optionally add a **Description** (internal use, up to 1000 characters)
6. Assign:
   * a **Manager** (Hierarchical mode), or
   * a **Principal Agent** (Horizontal mode)
7. Save the Squad

***

### Step 2: Add Agents to the Squad

Once the Squad is created, you can add Agents in two ways:

* **Link an existing Agent**\
  Use the *link* icon to attach an Agent to the Squad.
* **Create a new Agent**\
  Use the **+** button to create a new Agent that is automatically linked to the Squad.

Each Squad can contain multiple Agents, but only **one Manager or Principal** at a time.

***

### Promoting an Agent to Manager / Principal

You can change leadership at any time.

* In the Squad’s **Agents list**, open the Agent’s options menu
* Select **Promote to Manager** (or Principal)
* The previous Manager/Principal is replaced automatically

This is useful when:

* Reorganizing responsibilities
* Testing different orchestration strategies
* Iterating on Squad behavior without recreating it

***

### Copying the Squad ID

Each Squad has a unique identifier.

* Open the Squad’s options menu
* Click **Copy ID**

The **Squad ID** is useful for:

* Advanced inspection and debugging
* API-based interactions
* Referencing Squads in external systems or logs

> 💡 Tip: Keep the Squad ID handy when working with APIs or internal diagnostics.

***

### Managing Squads Over Time

Best practices for ongoing management:

* Keep Squad descriptions updated to reflect their real purpose
* Avoid adding Agents without a clear role
* Regularly review who acts as Manager/Principal
* Prefer **small Squads** with clear responsibilities