puda-protocol

Constraint

Must call the puda-memory skill immediately after creating or updating a protocol file. That skill keeps project.md as the source of truth; it will append the new protocol link and history entry.

Protocol Structure

A single protocol can contain commands for multiple machines. Each command specifies its own machine_id. Step numbers are sequential execution groups across all commands. If commands are meant to be executed in parallel, use the same step_number; however, machine_id cannot be repeated within the same parallel command group.

Top-level fields:

• project_id: UUID from project.md in the project root
• protocol_id: New UUID per protocol (e.g. python -c "import uuid; print(uuid.uuid4())")
• user_id, username: From puda config list
• description: Short description of what the protocol does
• timestamp: ISO 8601 UTC (e.g. datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"))
• commands: Array of command objects (see below)

Each command: