Discovery tutorials

These tutorials help you and your coding agent learn how to drive Discovery through the Artemis CLI. Rather than documenting commands in isolation, they use Particle Life as a small, measurable project and take you through complete workflows you can adapt to your own repository.

The agent can run most commands, apply the relevant Artemis skills, and explain the results. You remain responsible for credentials, account-level choices, and reviewing consequential decisions.

Where to start

Start with Get started with Particle Life. It establishes the shared setup—skills, CLI authentication, Git access, and a runner—and completes a Discovery run from import through result inspection.

The other tutorials assume that foundation is in place. Follow them in order for a progressive learning path, or choose the one that matches the problem you need to solve.

Tutorials

Get started with Particle Life

Learn the complete agent-assisted workflow: install the skills, authenticate the CLI, bring a runner online, import Particle Life, start Discovery, and inspect the winning change.

Make a repository ready

Start from a repository without a benchmark harness. Fork it, add compile, test, and benchmark commands that emit numeric Artemis results, import the prepared repository, and run Discovery.

Verifying commands on a runner

Validate compile, test, and benchmark commands in the environment where Discovery will execute. Use process logs to diagnose failures, fix the harness, pull the updated project, and verify it again.

Steer a running discovery

Start a focused run, redirect the active Discovery agent toward a different optimisation strategy, extend the version budget, and inspect how the run responded.

What you should take away

By the end of the series, you should understand how to use a coding agent and the Artemis skills to prepare a project, validate its execution pipeline, run and steer Discovery, and interpret the measured results from the CLI.