1. Define your Process

Write simple Markdown to define steps, commands, and rules. The runbook is your single source of truth.

# Hello

## 1 This is Rundown

Rundown transforms markdown into an executable specification.
Headings become steps, code-blocks become executable commands.
Human-readable. Agent-readable. Machine-executable.


## 2 Guide agents (and humans) through your process

Rundown keeps agents on track by injecting precision context at the exact moment it’s needed.


## 3 Make complex workflows deterministic
- PASS CONTINUE
- FAIL GOTO RECOVER

Rundown works *with* agents, adding guardrails that enforce transitions and improve accuracy.


## 4 Execute the right commands at the right time
- PASS CONTINUE
- FAIL RETRY GOTO RECOVER

Embed commands for automatic execution. Catch failure, retry, and recover gracefully.

```bash
rd echo npm run test
```


## 5 Track progress across agents and sessions
- PASS CONTINUE
- FAIL STOP

State-aware CLI ensures progress is never lost.
Save and resume complex processes at any time.


## 6 Ready to get started?
- PASS COMPLETE
- FAIL STOP

```bash
npm install -g @rundown/cli
```


## RECOVER Recover from errors
- PASS GOTO 4
- FAIL STOP

If you are here, an error occurred.
Named steps enable error handling and conditional logic.

2. Run the CLI

The CLI executes your markdown, guiding agents (and humans) step-by-step through the process.

Welcome to rundown

Initializing...

Initializing...

Step/7