run-plan

Plan an automated workflow run by discovering work items on disk, reconciling them with state.yaml, and generating suggested groupings that preserve sequential dependencies for deterministic execution.

Run scope planning is the process of discovering available tasks on disk, reconciling them with state.yaml, and suggesting execution groupings (single, batch, wide) to guide decisions before invoking run-execute.

Reconcile filesystem work items with state.yaml by scanning the filesystem for on-disk intents, comparing them against recorded state, and surfacing an up-to-date plan with suggested execution scopes.

Yes, you can batch execute grouped work items while preserving dependencies by selecting the batch or wide run-scope options, which group tasks sequentially within a single run to maintain deterministic execution.

Run planning supports single, batch, and wide execution modes by providing configurable run-scope options that suggest work item groupings based on dependencies and filesystem state before user selection.

Limitations of run scope planning include its reliance on filesystem discovery and state.yaml reconciliation, meaning on-disk intents must exist and be sequentially executable within a single run or grouped runs.