> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bluegenai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow

> Working in Prototype Mode: organising requirements into folders, prompting the agent, and setting the look with the Design System.

## The Workspace

The prototype workspace is compused of Three columns. **Requirement Folders** on the left, the **Conversation** in the middle, and **working panels** you open on the right.

<Frame caption="Prototype Mode with the Files panel open. The panel rail sits at the top right; opening a panel gives it the third column.">
  <img src="https://mintcdn.com/bluegenai/NDGsqiI6WIlzZ3zL/images/web-apps/prototype-mode-workflow-files.png?fit=max&auto=format&n=NDGsqiI6WIlzZ3zL&q=85&s=ecdfb6677c23cac61ea2c2a53b2a492c" alt="The Prototype Mode workspace with three columns: a Requirement Folders rail, the chat panel showing the welcome message, and the Files panel listing six project files with User and System badges." width="1440" height="813" data-path="images/web-apps/prototype-mode-workflow-files.png" />
</Frame>

## Requirement Folders

**A Requirement Folder groups related requirements and gives them their own conversation.** One folder per capability, per screen, or per process step, whichever matches how your team already talks about the system.

A new project starts with one folder named **Default**, holding nothing. Add folders with the `+` control at the top of the rail, and search them with the field below it.

Folders matter more than they look. Each carries its own conversation thread, so two people can work on separate parts of the same project without landing in each other's chat history. Switching back to Prototype Mode returns you to the folder you were last in.

<Tip>
  Organise folders the way you describe the system out loud: by capability (Intake, Case Management, Reporting), by screen (Login, Dashboard, Admin), or by process step (Submit, Review, Approve). Renaming and reorganising later costs nothing.
</Tip>

## Prompting the Agent

The composer sits under the conversation. Alongside the message box are a paperclip for attaching reference material and a quality selector.

**Describe the outcome rather than the interface.** The agent produces better results from "residents apply for a permit and staff review it" than from a description of forms and fields. Say who it is for, what they are trying to do, and any constraints that matter.

Attach anything that shows what you want: a solicitation, a brand guide, screenshots of a system you like. Attachments accept images and documents.

## The Panel Rail

Ten controls sit at the top right, each opening a panel over the third column. In Prototype Mode they are: **Files**, **Design System**, **URLs**, **Preview**, **Codebase**, **Database**, **Credentials**, **MCP Servers**, **Stop App**, and **Manage Collaborators**.

Two matter most while prototyping.

**Files** holds everything in the project, split into `User Uploaded` and `System Generated`. Anything you save from a conversation lands here, and this is where you find it again later.

**Design System** sets the look of everything the agent produces.

## The Design System

<Frame caption="The Design System opens over the full width, with controls on the left and a live preview on the right.">
  <img src="https://mintcdn.com/bluegenai/NDGsqiI6WIlzZ3zL/images/web-apps/prototype-mode-workflow-design-system.png?fit=max&auto=format&n=NDGsqiI6WIlzZ3zL&q=85&s=ba4ffd2e92e56148fbd595a96a5de81d" alt="The Design System overlay showing Quick Themes swatches, a font size selector, and colour controls on the left, beside a live preview of a sample application that re-renders as settings change." width="1440" height="813" data-path="images/web-apps/prototype-mode-workflow-design-system.png" />
</Frame>

Eight named themes give you a starting point: `Default`, `Forest`, `Purple`, `Sunset`, `Ocean`, `Rose`, `Mint`, and `Indigo`. From there you can set font size, font family, corner roundness, and every colour the interface uses, grouped into base colours, buttons and actions, and form fields.

The preview beside the controls is a working sample application. It re-renders as you change settings, so you see the effect before applying it. Changes are held until you select **Save Changes**, and **Discard** returns them.

Settling this early is worth the time. Everything the agent builds afterwards inherits it.

## Your Next Step

When the prototype is close enough to build from, the next question is what carries forward.

<CardGroup cols={2}>
  <Card title="Carry a prototype into a build" icon="arrow-right-arrow-left" href="/web-apps/prototype-mode/output-handoff">
    What moves between modes, and what you have to take with you.
  </Card>

  <Card title="See what Prototype Mode covers" icon="wand-magic-sparkles" href="/web-apps/prototype-mode/overview">
    What it produces, and what it deliberately leaves out.
  </Card>
</CardGroup>


## Related topics

- [Workflow](/web-apps/build-mode/workflow.md)
