Skip to main content
This quickstart will cover: Let’s get started!
1

Create your Account

Go to https://app.braingrid.ai and create an account.
We’re in private beta, so you’ll need to join the waitlist to get access. We’ll send you an invite as soon as we’re ready for you.
Once you’ve got your invite, create an account using your email, google, or github account.Give your organization a name and pick a username.
Create an account
2

Write your first requirement document

Next, let’s write your first requirement document. This will define what you want to build.You can watch our quick video walkthrough, or skip ahead to the step-by-step guide.
Let’s create your first requirement:Click on the “Create requirement” button.
Create requirement button in BrainGrid dashboard
For the purposes of this quickstart, we are going to write a requirement from scratch. You can also refine an existing requirement or break it down into tasks.
Select requirement creation method options
Select the repository that you want to work with. If you haven’t connected a repository yet, you can do that in the optional Connect GitHub step at the end of this guide.
Repository selection dropdown for requirement
Once you’ve selected the repository, you can describe what you want to build. For this Quickstart, we are going to use the example of “Need to support two-factor authentication”.Feel free to jot down any additional context that you think is important.
Requirement description input form
The agent will start thinking and analyzing the codebase. It can come back with some clarifying questions to help it understand the requirement better.
Agent analyzing codebase and asking clarifying questions
Once the agent has enough clarity, it will start writing the requirement document.
Completed requirement document preview
At this point, you can review the requirement document and make any changes you need. You can ask the agent to make changes, clarify things, add or remove details.Once the requirement reflects what you need, you can move on to the following step to break it down into implementation tasks.
For more details, see our Create Requirement Guide.
3

Break down your requirement into tasks

Now let’s break your requirement into atomic, actionable tasks that your AI coding assistant can execute.Follow along with the video demonstration, or jump to the written instructions.
Here’s how to break down your requirement:To break it down into implementation tasks, simply go to the “Tasks” tab and click “Break it down into tasks”.This will instruct the agent to break the requirement into atomic and verifiable tasks for your AI coding agent.
Tasks tab with break down into tasks button
The agent will proceed to look at the last details of the implementation, and break this requirement into properly scoped tasks for your AI coding agent.
Agent analyzing requirement to create tasks
Once the tasks are created, you can review them and make any changes you need. You can ask the agent to make changes, clarify things, add or remove details.Tasks provide a very detailed prompt for your AI coding agent to follow.
List of generated tasks with details
Once you are ready to start building, go to the next step to set up the MCP integration.
For more details, see our Break Down Tasks Guide.
4

Install the BrainGrid MCP

Now let’s connect BrainGrid to your AI coding assistant using the Model Context Protocol (MCP). This allows your AI assistant to directly access requirements and tasks.
  • Claude Code
  • Cursor
  • JSON Config
Add BrainGrid to your Claude Code configuration:
claude mcp add --transport http braingrid https://mcp.braingrid.ai/mcp
Then restart your Claude Code session. You’ll see that the BrainGrid MCP is available but needs authentication.
BrainGrid MCP in Claude Code
Enter /mcp to manage your MCP servers:
/mcp
Then you’ll see “BrainGrid disconnected - enter to login”
Manage MCP servers
Hit “Enter”, this will open a browser window to login to BrainGrid. Once you log in, you can approve the BrainGrid MCP to connect to your account.
BrainGrid login approval page
Once the authentication is complete, you’ll see “Authentication successful. Connected to BrainGrid.” and you can start using the BrainGrid MCP.
BrainGrid MCP connected
You can now use the BrainGrid MCP to create requirements and tasks.
Need more help? Check our detailed MCP installation guide.
5

Build it with your favorite AI coding tool

Now you’re ready to implement your tasks using your AI coding assistant!Watch how it’s done in the video, or go straight to the implementation steps.
Now let’s start building:You can simply copy the tasks and paste them into your AI coding tool like Cursor or Claude Code.You can also use the MCP and tell it to:
build REQ-218
Build tasks
The AI coding tool, in this example Claude Code, will use the MCP to fetch the requirement and all the tasks.
Build tasks
You can tell it to start building, or to build only certain tasks if you want to stop at a certain point to review.
Build tasks
For detailed implementation guidance, see our Build Tasks Guide.
6

Connect GitHub and analyze your codebase

This step is optional but recommended for better code understanding and requirement accuracy.
Click on the “Connect GitHub” button to connect your GitHub account. BrainGrid needs to analyze your codebase to help you create code-aware tasks and requirements.
Connect GitHub
You must have Admin or Owner permissions to install the BrainGrid GitHub App on a repository. Learn more about how to install the BrainGrid GitHub App.
Choose repository access.
Repository access
We recommend selecting only the repositories you plan to use with BrainGrid.Then, select the first repository you want to analyze. You can add more repositories later.
Analyze repository
Click on the “Analyze now” button to analyze the repository. BrainGrid will start analyzing your codebase.
This may take a few minutes depending on the size of your codebase.
Go to the Repositories page and see the documentation generated. These documents provide context for the BrainGrid agent to understand your codebase.
Codebase documentation
7

Automating acceptance criteria reviews

Lastly and most importantly, you can automate the acceptance criteria reviews.You can tell it to review REQ-218 so it reviews the implementation against the requirements.
review REQ-218
Congratulations! You’ve completed the quickstart. Now you can start building your product with BrainGrid!

​
Video Guides

Check out our complete Video Guides section for detailed walkthroughs of each step in the BrainGrid workflow.
⌘I