Skip to main content

Prompting supports two modes: Plan and Build.
Plan mode is especially helpful when you’re getting started—you can explore integration data and structure, clarify requirements, review strategy, and refine the prompt before building. Once you’re satisfied with the plan, switch to Build mode, where Clark executes the prompt to create or update your application.

Plan mode

You can interact with Clark in Plan mode to craft a detailed prompt before building. In this mode, Clark leverages read-only tools and will not make any changes to your application. Below are common actions Clark takes in Plan mode.

Inspecting integration metadata and running one-off queries

Clark checks integration metadata such as REST API specs and SQL table schemas to determine what resources to query. Similarly, Clark can run one-off queries to those data sources to read sample data and better understand its structure for rendering the UI.
Before running queries to your integrations, Clark asks for approval. You can approve / deny each request individually, or always allow a specific operation for an integration (e.g., automatically approve all read requests for a specific database integration but review all write operations for that integration individually).
Clark runs one-off queries in plan mode

Prompting for clarification around key features and design choices

Clark asks questions to understand the application’s required functionality, design, layout, and more. You can answer by selecting one of the multiple choice options or clarifying in the main chat. Clark asks clarifying questions in plan mode

Generating the plan

Once Clark fully understands the data, features, and implementation strategy, a plan is generated. You can reply back to edit the plan or click Build it to switch modes and have Clark start creating the application. Clark generated detailed application plan

Build mode

In Build mode, Clark gets to work creating the application. You can use Build mode on its own without any planning, which is ideal for smaller targeted edits or detailed prompts you’ve prepared ahead of time.
Clark in Build mode
In this mode, Clark uses various build tools to perform operations including:
  • Creating pages and component files
  • Writing and compiling backend APIs
  • Installing libraries
You can expand these tool calls in the chat to inspect details around Clark’s thought process and the generated code.
Clark creating files

Testing and debugging

In the same way Clark acts like a human engineer in Plan mode by running one-off queries and checking API responses, Clark performs similar actions in Build mode to iteratively test, debug, and edit features as they’re built. This includes:
  • Testing APIs
  • Checking code for issues
  • Checking for runtime errors and inspecting console logs
  • Capturing screenshots to confirm UI renders as expected
Clark testing APIsClark testing APIs
Clark in Build mode debugging
Once all requirements are fulfilled and checks pass, Clark finalizes the app, making it available for you to interact with and continue building. Clark completes first build