Skip to content

wbWorkflow — Concept Hub ​

How wb-flow commands compose into repeatable, multi-step workflows.


What is a Workflow? ​

A workflow in wb-flow is a deliberate sequence of commands that accomplishes a goal larger than any single command can handle. While each /wb* command is self-contained, the real power emerges when commands are chained with intention.

The key insight: workflows are not scripts. They're not automated pipelines. They're human-directed sequences where you choose the next step based on the output of the previous one. The AI executes each step; you steer.


The Three Workflow Layers ​

LayerWhat It CoversKey Pages
ArchitectureHow commands interact, what state they share, what contracts they enforceWorkflow Architecture
LifecycleThe canonical sequence from session start to session closeUltimate Workflow Lifecycle
SequencingHow tasks within a plan are ordered and executed using DAG dependenciesSequencing

The Canonical Daily Workflow ​

Most days follow this pattern:

Orient      →  /wbStandup + /wbContext
Plan        →  /wbPlan (if work is complex)
Execute     →  /wbWork (repeat per task)
Validate    →  /wbValid
Commit      →  /wbGit
Close       →  /wbStopTrack

Each step reads state left by the previous step. /wbStandup surfaces open tasks; /wbPlan decomposes them; /wbWork executes them; /wbValid checks the result; /wbGit commits. The chain is held together by the reports/ file tree, not by in-memory state.


Presentation Layers ​

For different depths of explanation:

  • ELI5 — The workflow concept explained simply
  • Practical — Real scenarios and command chains
  • Expert — Architecture, state flow, and design decisions

How This Relates to Other Concepts ​

ConceptRelationship
Command ClassificationDefines the role types (Worker, Validator, Critic...) that compose workflows
Command CompositionRules for chaining commands (what can follow what)
Plan State ManagementHow plan files carry state across commands
Session LifecycleThe start-to-finish session pattern that workflows live inside