> For the complete documentation index, see [llms.txt](https://help.intangible.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.intangible.ai/canvas/the-brief.md).

# The brief

The brief is the written plan for your project, made from your prompt and files. Check it, edit any section, and confirm it once to start the build.

With Guide me on, the agents write down what they are going to build before they build anything. That written plan is the brief. It turns a loose prompt and a few photos into something specific enough to build from: what the project is, what it is for, and which shots it needs.

The brief is the one decision most projects need from you. Confirm it and the agents run the rest.

## Where the brief comes from

You start a project on Home with a prompt and, if you have them, files. Then:

* **Choose Guide me** and they can ask questions first, one at a time, each as a choice card: whether you have photos or a model of the subject, whether there are brand guidelines, how it should feel. Then they write the brief from your answers.

![Two questions arrive in the chat, each with options to pick from, one on the look and one on a character's suit; each answer shows in the chat, then the agents start drafting the brief](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-27a1a0b7cd30f46e01018bfd5f1dea9b151ea063%2Fcanvas-agent-questions-01.gif?alt=media)

With **Skip** on, the agents don't ask the guiding questions or wait for you to confirm: they make the open calls themselves, say in the brief which ones they made, and go straight on to build the scenes and shots and render an image of each shot, which spends credits. They still ask before making a video. A brief can still land on the canvas, because it comes out of the build; read and edit it the same way. Choose Guide me when you want to agree the plan first.

The same **Guide me** / **Skip** menu sits next to **+** in the chat panel, so you can switch mid-project: pick Guide me before asking for a change you want to approve first. See [Chat with Intangible](https://help.intangible.ai/chat-agents-intangible/chat-with-intangible.md#guide-me-or-skip).

When the brief is ready, the status reads "waiting for your answer". See [Start a project](https://help.intangible.ai/get-started/start-a-project.md).

## What is in it

The brief appears as a card at the top of the canvas's first column. It shows:

* **The domain,** for example Aerospace, and under it **your original request,** word for word, as Original request: "…". A short prompt shows in full. A longer one stops at four lines; click **Show more** to read the rest in place and **Show less** to fold it back.
* **Sections** the agents write for this project. A five-shot run had Direction (with the signature moment), Subjects, Tone & style, Scenes & shots, Audience and Other decisions.

Anything the agents guessed rather than took from you is marked *(assumed)*, for example "Investors and partners (assumed)" under Audience. Read those first.

The card grows with its content, and the groups below it move down to make room. It follows the app theme, light or dark. To pan the canvas while zoomed in on the brief, drag from anywhere on the card; a click without a drag still opens a section for editing.

Each subject in the brief gets its own named group on the canvas, under **Groups**, for example Airbag pod, Rover and Lunar crater. Images you added move out of **Sources** into the group of the subject they show, and after you confirm, the agents start one reference sheet for each subject group.

## Edit it

If you are an editor or owner of the project, click any section's text to edit it.

* Press **Cmd+Enter** (Mac) or **Ctrl+Enter** (Windows), or click away, to save.
* Press **Escape** to cancel.

Section names belong to the agents; you edit what each section says. Edit before you confirm: a change to the brief is cheaper than a change to a built scene.

## Change the idea after you confirm

The brief stays editable after you confirm it. When the idea itself is wrong (the wrong product, the wrong audience, a shot you no longer need), fix it here, at its source, rather than patching each render.

Editing the brief rebuilds nothing on its own. The references, models, scene and shots made from it stay as they are until you ask. After you save the change, tell the agents what to update in the chat panel, for example "I changed the location in the brief to a rooftop at dusk. Update the scene and the shots to match."

Fix a problem where it starts: the brief for the idea, the scene for anything that repeats across shots, a single output for a one-off. See [Edit media](https://help.intangible.ai/canvas/edit-media.md) for one-off fixes.

## Confirm it

In the chat panel, the brief arrives with a choice card that asks whether to confirm it or edit it first. The agents word the options themselves, for example **Confirm, start building** and **I'll edit it first**. Pick the confirm option and the status changes to "building your scene". The step list appears in the thread, and a step that spends credits, such as starting three reference sheets, carries its cost in the step text. See [Status and steps](https://help.intangible.ai/chat-agents-intangible/status-and-steps.md).

If the brief is not right, pick the option to edit it first and edit the card, or tell the agents what to change in the chat panel.

## Related

* [Chat with Intangible](https://help.intangible.ai/chat-agents-intangible/chat-with-intangible.md) – choice cards and how to answer them.
* [What Intangible agents build](https://help.intangible.ai/canvas/what-intangible-agents-build.md) – what happens after you confirm.
* [Groups and cards](https://help.intangible.ai/canvas/groups-and-cards.md)
* [Brief AI like a DP](https://help.intangible.ai/learn-more/how-to/brief-ai-like-a-dp.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.intangible.ai/canvas/the-brief.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
