> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skarmy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Organise your workspaces

> Group workspaces by department, star the ones you use, move one to another company, and delete what you no longer need.

The **Workspaces** page lists everything your company is making, one compact row per workspace, grouped under department headers. This page covers keeping it organised as your company grows.

## Before you start

You need at least one workspace. The coach creates your first one at handoff, or you can create one yourself here.

## The page

Select **Workspaces** in the sidebar. Each row shows the workspace's name and either its published address or `Not published`. Above the list:

* A search box.
* Filter pills: **My workspaces**, **Recently viewed**, **Starred**.
* A **New workspace** button.

Your ten most recently opened workspaces also appear in the sidebar under **Recent Workspaces**, so you rarely need this page just to get back to work.

## Departments

Workspaces are grouped by department, in this order:

**Engineering** · **Design** · **Legal** · **Marketing** · **Hiring** · **Research** · **Finances**

A new workspace starts in Engineering. To move one, open the row's **⋯** menu and pick **Department**, then the destination. Departments only group the list — a workspace behaves the same wherever it sits.

## Create a workspace directly

The coach usually creates workspaces for you at handoff, but you can start one by hand.

<Steps>
  <Step title="Select New workspace">
    A dialog appears: **New workspace** — name it and pick the department it belongs to.
  </Step>

  <Step title="Fill it in">
    * **Name** — up to 80 characters.
    * **Department** — where it files in the list.
    * **First task (optional)** — the prompt reads `What should this workspace start on?`. Whatever you write becomes the Builder's opening message.
  </Step>

  <Step title="Create it">
    **Expected result:** the workspace opens, and if you gave it a first task, the Builder starts on it.
  </Step>
</Steps>

## The row menu

Each row's **⋯** menu holds:

| Action                | What it does                                                                         |
| --------------------- | ------------------------------------------------------------------------------------ |
| **Star** / **Unstar** | Pins the workspace into the **Starred** filter. Stars are saved on this device only. |
| **Department**        | Moves it under a different department header.                                        |
| **Move to**           | Moves the workspace to another of your companies.                                    |
| **Delete**            | Removes the workspace for good — see below.                                          |

## Delete a workspace

Deleting is permanent, and it takes your published site with it.

> Delete {name}? Its chats, files, and published site will be gone for good. Type **delete** to confirm.

<Warning>
  Deleting a workspace also retires its `yourname.skarmy.ai` address permanently — the name cannot be claimed again, by you or anyone else. If the site matters, leave the workspace alone.
</Warning>

## Verify

* Your workspace appears under the department you chose.
* The **Starred** filter shows what you starred.
* A deleted workspace is gone from the list and its address no longer serves.

## Troubleshooting

| Problem                                    | Fix                                                                                                 |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------- |
| A workspace is missing                     | Check the company switcher — workspaces belong to one company, and the list follows the active one. |
| Stars disappeared on another device        | Stars and recency are saved per device. They do not sync.                                           |
| You moved a workspace to the wrong company | Open the row menu again and move it back.                                                           |

## Next

<Columns cols={2}>
  <Card title="Work with the Builder" icon="hammer" href="/build/work-with-the-builder">
    Open a workspace and keep building.
  </Card>

  <Card title="Site addresses" icon="globe" href="/publish/site-addresses">
    What happens to an address when a workspace goes away.
  </Card>
</Columns>