vd-next (VibeDev Next Step Driver)

Goal

Make “type $vd-next repeatedly” a reliable workflow:

• fetch the next step prompt from the VibeDev server
• respect NEWTHREAD / AWAITHUMAN / DIAGNOSE
• print the exact prompt to run next (with the server’s completion marker)

How to run (scripted)

Run the bundled script:

• python skills/vd-next/scripts/vd_next.py

Common options:

• --job-id <JOB_...> (if omitted, picks the first EXECUTING job)
• --server http://127.0.0.1:8765
• --json (print raw JSON response)

Expected loop

1. User calls $vd-next
2. Fetch next action from /api/jobs/{job_id}/next-prompt-auto
3. Output:

- If action=NEXTSTEP or RETRY: print the prompt to execute - If action=NEWTHREAD: instruct user to start a new thread and print the seed prompt - If action=AWAIT_HUMAN or DIAGNOSE: stop and tell user what to do

1. After the step is done, the agent (or user) submits evidence via VibeDev tools / UI
2. Repeat

Notes:

• Breakpoints are implemented as a normal step that produces a Memory Pack and sets a NEW_THREAD flag for the following step.
• Memory Packs should be saved as context blocks tagged carryforward (and optionally carrytostep:<stepid>).