vd-create (Workflow Authoring Assistant)
Goal
Turn a user’s project idea into a visual, editable workflow graph in the Studio:
- four phases:
research, planning, execution, review
- node types:
PROMPT, CONDITION (hard/soft), BREAKPOINT
- explicit edges (
nextStep, and for conditions onPass/onFail)
- each prompt step includes: role/context/task/guardrails/deliverables +
logInstruction
This skill is for authoring a UnifiedWorkflow graph — not for executing steps.
Key tools
Use the unified workflow tools (these update job_ui_state.graph_state_json.unified_workflows):
workflow_unified_get
workflow_unified_set_flow_fields
workflow_unified_upsert_step
workflow_unified_connect
workflow_unified_delete_step (rare)
Authoring workflow (no fluff, concrete)
1) Intake (ask only what you need)
Collect:
- What are we building? (1–2 sentences)
- User technical level:
non-technical | some coding | experienced
- Constraints: language/framework, OS, timeline, “must-have” vs “nice-to-have”
- Definition of “done”: what can the user do when it’s complete?
2) Decide a graph shape (recommended default)
Create 3–6 steps per phase. Keep each step one prompt.
Recommended minimal skeleton:
- Research: scope + repo scan (findings), risk scan (mistake ledger), breakpoint (memory pack)
- Planning: architecture choices, step plan draft, breakpoint (handoff memory)
- Execution: implement incrementally, add tests, condition (tests pass), breakpoint (handoff)
- Review: run full verification, condition (all gates), final summary
3) Write the graph into the job
For each phase:
- Call
workflow_unified_set_flow_fields to set name, description, global_context.
- For each node, call
workflow_unified_upsert_step with a full step object.
- Call
workflow_unified_connect to wire nextStep / onPass / onFail.
Step object requirements
Match the Studio schema:
id: stable string (recommend step_<phase>_<slug>)
type: PROMPT | CONDITION | BREAKPOINT
label: Step1, Step2, Sub1, etc.
title: human readable
colIndex: integer
subThreadLevel: integer
isSubThread: boolean
PROMPT fields:
role, context, task, guardrails, deliverables, logInstruction
CONDITION fields:
conditionType: script (hard) or llm (soft)
conditionCode: for llm, a TRUE/FALSE question; for script, a command line to run
onPass, onFail (or use workflow_unified_connect with edge=on_pass/on_fail)
BREAKPOINT fields:
reason
carryForward (memory prompt — instruct model to save a memory pack to context, not print it)
4) Confirm and hand off to the user
- Tell the user which job/phase you updated and that it’s visible in the Studio.
- Encourage them to edit anything, then start execution with
$vd-next.
Guardrails
- Keep steps small and explicit.
- Prefer conditions as separate nodes (don’t embed “gates sections” in prompts).
- Breakpoints should instruct “save memory pack to context” and “start a new thread”.
1---2name: vd-create3description: Create or refine a VibeDev Studio UnifiedWorkflow graph via tool calls. Use when the user says `$vd-create`, asks the model to “build the workflow graph”, “set up Research/Planning/Execution/Review steps”, or wants the model to collaboratively design prompts/conditions/breakpoints and write them into `unified_workflows` so the UI canvas shows the plan before running `$vd-next`.4---5
6# `vd-create` (Workflow Authoring Assistant)
7
8## Goal
9
10Turn a user’s project idea into a **visual, editable** workflow graph in the Studio:
11- four phases: `research`, `planning`, `execution`, `review`
12- node types: `PROMPT`, `CONDITION` (hard/soft), `BREAKPOINT`
13- explicit edges (`nextStep`, and for conditions `onPass`/`onFail`)
14- each prompt step includes: role/context/task/guardrails/deliverables + `logInstruction`
15
16This skill is for **authoring** a UnifiedWorkflow graph — not for executing steps.
17
18## Key tools
19
20Use the unified workflow tools (these update `job_ui_state.graph_state_json.unified_workflows`):
21- `workflow_unified_get`
22- `workflow_unified_set_flow_fields`
23- `workflow_unified_upsert_step`
24- `workflow_unified_connect`
25- `workflow_unified_delete_step` (rare)
26
27## Authoring workflow (no fluff, concrete)
28
29### 1) Intake (ask only what you need)
30
31Collect:
32- What are we building? (1–2 sentences)
33- User technical level: `non-technical | some coding | experienced`
34- Constraints: language/framework, OS, timeline, “must-have” vs “nice-to-have”
35- Definition of “done”: what can the user do when it’s complete?
36
37### 2) Decide a graph shape (recommended default)
38
39Create **3–6 steps per phase**. Keep each step *one prompt*.
40
41Recommended minimal skeleton:
42
43- Research: scope + repo scan (findings), risk scan (mistake ledger), breakpoint (memory pack)
44- Planning: architecture choices, step plan draft, breakpoint (handoff memory)
45- Execution: implement incrementally, add tests, condition (tests pass), breakpoint (handoff)
46- Review: run full verification, condition (all gates), final summary
47
48### 3) Write the graph into the job
49
50For each phase:
511. Call `workflow_unified_set_flow_fields` to set `name`, `description`, `global_context`.
522. For each node, call `workflow_unified_upsert_step` with a full step object.
533. Call `workflow_unified_connect` to wire `nextStep` / `onPass` / `onFail`.
54
55**Step object requirements**
56
57Match the Studio schema:
58- `id`: stable string (recommend `step_<phase>_<slug>`)
59- `type`: `PROMPT | CONDITION | BREAKPOINT`
60- `label`: `Step1`, `Step2`, `Sub1`, etc.
61- `title`: human readable
62- `colIndex`: integer
63- `subThreadLevel`: integer
64- `isSubThread`: boolean
65
66PROMPT fields:
67- `role`, `context`, `task`, `guardrails`, `deliverables`, `logInstruction`
68
69CONDITION fields:
70- `conditionType`: `script` (hard) or `llm` (soft)
71- `conditionCode`: for `llm`, a TRUE/FALSE question; for `script`, a command line to run
72- `onPass`, `onFail` (or use `workflow_unified_connect` with `edge=on_pass/on_fail`)
73
74BREAKPOINT fields:
75- `reason`
76- `carryForward` (memory prompt — instruct model to save a memory pack to context, not print it)
77
78### 4) Confirm and hand off to the user
79
80- Tell the user which job/phase you updated and that it’s visible in the Studio.
81- Encourage them to edit anything, then start execution with `$vd-next`.
82
83## Guardrails
84
85- Keep steps small and explicit.
86- Prefer conditions as separate nodes (don’t embed “gates sections” in prompts).
87- Breakpoints should instruct “save memory pack to context” and “start a new thread”.
88