docs: explain invalid intermediate draft routes

This commit is contained in:
lda
2026-06-28 03:31:19 +07:00 Verified
parent 8898401d06
commit 3fd2f573db
2 changed files with 52 additions and 2 deletions
@@ -65,6 +65,11 @@ Top-level workflow output uses `path` / `target`, not step-level
If a patch returns `revision_conflict`, fetch the workspace again and retry
against the latest revision.
Forward routes in drafts are allowed as invalid intermediate state. If
`wf draft add-step --route ok=collect` returns `status: invalid`, add the
missing `collect` step next, then run `wf draft validate`. Do not save or
compile until validation is valid.
## Focused Helpers
Prefer focused helpers over JSON Patch for common edits: