# Analyses

> Keep a spike in one place: documents, variants and findings for a ticket, read by you and by agents, exported when someone else needs it.

An analysis is what you do to find out where things are and how many ways there are to tackle them, before you build. It holds documents of four kinds: **analysis**, **variant**, **finding** and **plan**. Agents call it an investigation, and the tools are named `investigation_*`.

Analyses are kept in DevHub, not in a vault. A document can point to vault notes and open them.

## When to use it

- You look into something before building it and want the result to survive the session.
- Several agents should read the same background and the decisions reached.

[Screenshot: The Analyses screen with a board of cards in the columns To do, In progress and Closed, each card with its ticket key, title and how many documents are verified. The sample data shown is made up.]

## The board

Open **Analyses** in the **Docs** group of the sidebar. Cards stand in three columns: **To do**, **In progress** and **Closed**. Search by name or by a ticket key such as VAR-123, and filter by organization and repository. **Show closed** unfolds the closed ones. A card shows how many of its documents are verified and the plan made from it, if any.

## Work on one

1. Click **New analysis**, or the plus in the To do column.
2. Click the card to open the analysis window. Use **Add document** to add a document, then write it, or ask an agent to expand a draft.
3. Set the status of each document. The suggestions are draft, active, verified, superseded and archived; you can type your own word. It saves at once.
4. When the question is settled, click **Close analysis**. **Reopen** brings it back.

The **Links** tab of a document lists the vault notes it points to. **Open in the vault** opens one.

## Make a plan from it

**Create a plan from this** turns the result into a [plan](/devhub/features/plans/index.md). The card then shows the plan and its phase.

## Share it

**Export** saves an analysis as Markdown (.md), PDF or Word (.docx). **Copy call** copies the `investigation_read()` call for an agent. The queue icon adds the analysis to [AI Context](/devhub/features/ai-context/index.md).

## Remove one

**Remove** deletes the analysis and every document in it. DevHub asks first, and it cannot be undone.

## Related

- [Plans](/devhub/features/plans/index.md)
- [Vaults](/devhub/features/vaults/index.md)
- [AI Context](/devhub/features/ai-context/index.md)