musketeer run new

The run new command creates a new execution run.

Usage

musketeer run new

What it does

Creating a new run:

1. Generates a UUID as the replay_id
2. Creates a run directory at .musketeer/runs/<replay_id>/
3. Writes five YAML files with the replay_id set

The five files created:

File	Purpose
intent.yml	Goal and desired outcome (defaults to “Untitled” / “TBD”)
constraints.yml	Scope, non-goals, and allowlist (all empty)
plan.yml	Tasks to execute (empty)
progress.yml	Sequenced progress entries (empty)
handoff.yml	Handoff notes (empty)

Options

The run new command takes no options.

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:

• Check status to see run details
• Edit the YAML files to define intent, constraints, and plan
• Validate with check to verify structural integrity