Show HN Rundown transforms docs into executable workflows

1 points by tobyhede a month ago · 1 comment · 2 min read

I have been working on this hare-brained scheme to help agents who want to code good and do other things good too.

Introducing: Rundown (https://rundown.cool)

I think of Rundown runbooks as executable Skills. The Skill provides the detailed context, and the Rundown runbook keeps the agent on track.

    # 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 progresss 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.