# The board

The board shows every card your teams are working on, in columns from idea to done. Moving a card between columns is
how you tell Andon what to do with it: a card moved into Working starts running on a machine.

## The columns

Each column has a role. The role, not the column's name, decides what Andon does with a card there.

| Column | What happens there |
|---|---|
| **Backlog** | New cards and captures wait here. Press `B` to show or hide it |
| **Ready** | Cards that are ready to build. They wait until you run them, or until Autopilot starts them |
| **Working** | Moving a card here starts its run |
| **Review** | Finished runs wait here for you, with their outputs or pull request |
| **Done** | Approved work. The board shows the five newest; **Show more** under the column shows the rest |

A workspace can also have an **Inbox**, where captures land, and a **Next** column. **Simplify to the 4-column layout** on the
Columns page (below) removes them and hides the Backlog.

## Add a card

- Press `N`: a new card goes to the Backlog, which opens if it is hidden.
- Click **New card** in the toolbar, or use a column's add row and, when the team has card templates, its **New from
  template…**.
- Press `W` for [Start work](https://andon-docs.pages.dev/guide/start-work.md), which makes a card, an import or a plan from one sentence.

## Move a card

- Drag it to another column, or to another place in its column.
- Select it and press a number: `1` moves it to the first column shown, `2` to the second, and so on.
- Right-click it and pick **Move To**.
- Open it and change **Column** in its details.

Every move shows a toast with Undo. While Autopilot builds a team, Andon moves that team's cards into Working and
Review itself, so those columns are shown but can't be picked in the menus. See [Autopilot](https://andon-docs.pages.dev/guide/autopilot.md).

Dropping a card onto another card can also group the two into one pull request, or make one a sub-task of the
other. See [Shortcuts](https://andon-docs.pages.dev/guide/shortcuts.md#dragging).

## What a card shows

A card on the board shows its key and title, its team and project, its labels, and its run: a badge with the run's
state, such as working, waiting for you or failed. A card that needs you pulses amber. Cards that ship together in
one pull request are stacked: click the stack to open it.

The board's toolbar switches the layout (Board, List or Timeline), filters it, picks cards with **Select**, and opens
**Autopilot**. See [Views, the filter bar and swimlanes](https://andon-docs.pages.dev/guide/views.md) to filter the board, save views and split it into
lanes by team or project.

## Card keys

Every card has a key made of its team's key and a number: `WEB-12` is the twelfth card in the team whose key is
`WEB`. A card with no team takes the workspace's key. Numbers are given when the card is made and never reused.

Use the key anywhere you'd name the card:

- `⌘K` finds a card by its key.
- `/card/WEB-12` opens it.
- The `andon` command takes it: `andon run WEB-12`.
- Branches carry it: `andon-web-12-<title>`.
- A pull request names it with `Card: WEB-12` in its description.

A card imported from Linear or Jira keeps its tracker's key, such as `ENG-42`, as a link chip, and gets an Andon key
of its own. Search finds it by either.

### Change a team's key

1. Open **Settings → Teams**, pick the team, and find **Key** under **Identity**.
2. Type 2 to 5 letters or digits. The line under it shows what the cards' keys will look like.

The team's cards take the new key. Their old keys keep working, in search, in links and on the command line. A card
that moves to another team takes that team's next number, and its old key keeps working too. Only owners and admins
change keys.

## Team statuses

A team can split a column into its own statuses, such as *In progress* and *In QA* in Working. Each status belongs to
one column, and each column a team uses has one default status.

### Add a status

1. Open **Settings**, search for **Team statuses**, and pick it. The **Columns** page opens.
2. Pick the team in **Team**.
3. In the column you want, type the status's name in **Add a status to …** and press `Enter`.
4. Pick its colour from the dot beside it: gray, blue, violet, amber or green.

Changes save as you make them. You can also rename a status, move it to another column, move it up or down, and
**Make default**. Only owners and admins change statuses.

### How the board shows them

Filter the board to one team and each column with two or more of its statuses splits into them, under the column's
name. Drag a card between two statuses of a column to change its status and nothing else. Elsewhere, a card shows its
status as a chip.

When Andon moves a card, it lands on the default status of its new column. A status you picked stays while the card
stays in its column.

A sub-team with no statuses of its own uses its parent's. Once it adds one, its cards stop using the parent's.

### Fill new cards from a template

Under a status, **A card landing here gets** picks a [card template](https://andon-docs.pages.dev/guide/templates-and-bulk-edit.md). A card that lands
in that status is filled from the template once.

### Write back a status to Linear or Jira

Write-back moves a linked issue by column. To use a tracker state of your own instead, click the link icon on a status
and type the Linear state or Jira status to use while a card is in it.

### Delete a status

Click the bin on its row and pick where its cards go. They stay in their column. The delete is recorded in the audit
log.

## Columns

Search Settings for **WIP limit** or **Column role**, or open `/settings/columns`, to change the workspace's columns.
Owners and admins can rename a column, set its **WIP limit**, hide it from the board (**Shown**), change its **Role**,
add one with **New column**, or **Simplify to the 4-column layout**: Ready, Working, Review and Done.
