Skip to content

Commit 058297b

Browse files
committed
docs(workflow): teach recovery without budget stub
1 parent c8f0b65 commit 058297b

1 file changed

Lines changed: 22 additions & 2 deletions

File tree

skills/dynamic-workflows/SKILL.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,14 @@ review, migrate-and-verify, research panels — **not** a single subagent turn.
1717

1818
```bash
1919
devspace workflow run --file path/to/script.js [--arg k=v]... [--follow]
20+
devspace workflow run --script-path path/to/script.js [--resume <runId>] [--follow]
2021
devspace workflow run --name review-auth [--follow]
2122
devspace workflow run --resume <runId>
2223
devspace workflow status <runId> [--follow]
2324
devspace workflow cancel <runId>
2425
devspace workflow ls
26+
devspace workflow calls <runId>
27+
devspace workflow call <runId> <callIndex>
2528
```
2629

2730
Named scripts: `.devspace/workflows/<name>.js` or `workflows/<name>.js`.
@@ -57,7 +60,6 @@ return { summary, findings }
5760
| `pipeline(items, ...stages)` | Per-item chains; no cross-item barrier |
5861
| `phase(title)` / `log(msg)` | Progress; journaled |
5962
| `args` | Run input (object preferred) |
60-
| `budget` | Stub: `total: null`, `remaining(): Infinity` — do not loop on budget alone |
6163
| `workflow(name\|{scriptPath}, args?)` | Nested, depth 1, shared call index |
6264

6365
**No `writeMode`.** Teach read-only vs write in the prompt. Use `isolation: 'worktree'` when parallel mutators would conflict (git required).
@@ -86,7 +88,25 @@ Default: first **enabled ∩ available** provider (`agentProviders.enabled` in c
8688

8789
### Resume
8890

89-
`devspace workflow run --resume <runId>` creates a **new** run that replays completed agent calls by cache key (callIndex+key, then consume-once by key).
91+
Failed and cancelled runs are terminal. Recovery creates a **new** run:
92+
93+
1. Inspect the prior run with `workflow status`, `workflow calls`, and
94+
`workflow call`.
95+
2. Edit the persisted `scriptPath` reported by the run, or pass a different
96+
`--script-path`.
97+
3. Keep prompts and agent options stable for completed calls whose return values
98+
should be reused.
99+
4. Run `devspace workflow run --resume <runId>` (optionally with
100+
`--script-path <path>`).
101+
102+
Replay first matches the same call index and cache key, then consumes one
103+
compatible prior cache key after reordering. The new run records whether each
104+
call was reused by same-index or compatible-key matching, and where it came
105+
from. Failed, interrupted, changed, or unmatched calls execute live.
106+
107+
Replay restores an agent's **return value**. It does not recreate shared-checkout
108+
edits or reapply a prior worktree diff. Verify required filesystem state before
109+
depending on a replayed mutating call.
90110

91111
### Cancel
92112

0 commit comments

Comments
 (0)