> For the complete documentation index, see [llms.txt](https://docs.rainbird.ai/rainbird/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainbird.ai/rainbird/rae/before-you-start.md).

# Before you start

What you need before your first project, and what to expect from it.

### What you need

1. **An account in Rae.** [Sign-up for Rae](https://app.raelog.ai/#signup) for free.
2. **A decision to model.** Prepare a brief that describes it, and the documents or web pages that define it. See [Write a project brief](https://docs.rainbird.ai/rainbird/rae/before-you-start/write-a-project-brief.md).

### What to expect

* **It takes a while.** A first update typically takes 1-2 hours. Large documents or web research can take longer. It runs on the server, so you can close the tab. Turn on notifications to hear when it finishes or needs you.
* **It asks when required.** The agent stops when an answer would change the result. Otherwise, it makes a careful call and records it in the documentation.
* **It delivers a draft to review.** The model is validated, tested, and documented. It encodes what your brief and documents say. Read the documentation and coverage map, run the tests, and try the edge cases you know.
* **Every update is a new version.**  Each completed update delivers a new graph. You can make any version current again in one click.

### Words you will meet

| Word          | Meaning                                                                                                    |
| ------------- | ---------------------------------------------------------------------------------------------------------- |
| **Project**   | The home for one knowledge domain: its conversation, knowledge, tests, versions, endpoint, and files.      |
| **Update**    | One piece of work by the agent. The first builds the graph. Each later one starts from a plan you approve. |
| **Version**   | The graph an update delivered: v1, v2, or v3. Only one is current.                                         |
| **Endpoint**  | The project's MCP address. It always serves the current version.                                           |
| **Knowledge** | What the agent draws on: your documents and web pages, plus what earlier updates captured.                 |


---

# 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://docs.rainbird.ai/rainbird/rae/before-you-start.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.
