Skip to main content

Make a Plan

1. Start a Plan​

Open Plan in the Project sidebar. Describe what you want in the composer at the top, or start from one of the suggestions such as Build a new feature, Generate Tests, Generate Benchmarks, Improve Security or Refactor the codebase. Choose a model and send.

You can also bring in an existing Plan with Import Plan, which takes a CSV file.

2. Answer the planning questions​

The planning agent asks questions to gather the context it needs, such as scope, constraints or preferred tools. For each one you can pick a suggested answer, write your own, or skip the remaining questions and let the agent proceed with what it has.

3. Review the Tasks​

The agent then proposes the Plan. The Tasks table shows each Task with its step, phase and status, and an icon for whether it is an agent Task or a user Task. Expand a Task to read and edit its name, description and prompt. Remove a Task you do not need from its actions menu.

To change the Plan more broadly, ask in the planning chat, for example to add a Task, split one in two or reorder the phases. The agent may ask a short follow-up question and then updates the Plan.

4. Export or save the Plan​

From the Plan's actions you can:

  • Export the Plan as Markdown (View Markdown), CSV or ZIP.
  • Save plan to repository, which commits the Plan to a fresh Branch as .artemis/plan-<id>.md. The Plan can then be reviewed like code, or improved by a Discovery Run before anyone builds it.
  • Build with Discover, which opens Discover with the Plan as the starting point for a Discovery Run.

Next step​

When the Plan is ready, continue with Build and verify the Plan.