musketeer run new

The run new command creates a new execution run.

Usage

musketeer run new

What it does

In SMALL-native mode:

1. Generates a UUID as the replay_id
2. Creates a run directory at .musketeer/runs/<replayId>/
3. No shadow artifacts are written to .small/ - canonical state remains SMALL-owned

The run directory is where Musketeer-owned execution artifacts (execution logs) are written during the run lifecycle.

Replay ID

Each run gets a UUID as its identifier, for example:

a1b2c3d4-e5f6-7890-abcd-ef1234567890

Use this ID with --replay in other commands to reference the run.

Example

musketeer run new

Output:

Created run <replay_id>

Next steps

After creating a run:

• Generate a role packet with musketeer packet --role planner
• Edit the SMALL artifacts in .small/ to define intent, constraints, and plan
• Validate with check to verify structural integrity