Context
build/fundamentals/workflows.md covers @Transition, wait: true, state typing, and priority — but does not mention @Guard. Branching is a first-class concept (every non-trivial workflow has it) and the only way readers learn the @Guard('methodName') pattern is by querying the docs a second time with a guard-specific prompt or reading source. The priority field is shown but its semantics (higher first; unguarded transition acts as fallback) aren't explained on the main page.
What to do
Add a top-level "Branching with guards" section to build/fundamentals/workflows.md covering the decorator, the priority + fallback rules, and a complete example.
Affected area
- Docs:
build/fundamentals/workflows.md
Acceptance criteria
Additional context
Surfaced during a benchmark agent session. See todo-docs.md#6.
Context
build/fundamentals/workflows.mdcovers@Transition,wait: true, state typing, andpriority— but does not mention@Guard. Branching is a first-class concept (every non-trivial workflow has it) and the only way readers learn the@Guard('methodName')pattern is by querying the docs a second time with a guard-specific prompt or reading source. Thepriorityfield is shown but its semantics (higher first; unguarded transition acts as fallback) aren't explained on the main page.What to do
Add a top-level "Branching with guards" section to
build/fundamentals/workflows.mdcovering the decorator, the priority + fallback rules, and a complete example.Affected area
build/fundamentals/workflows.mdAcceptance criteria
Additional context
Surfaced during a benchmark agent session. See
todo-docs.md#6.