# Workflows Layer

This file documents the workflows orchestration layer.

## Scope

This layer owns control flow:

- workflow sequencing
- retries and revision loops
- branching and merge orchestration
- handoff between workflow steps and agents

It does not own shared runtime internals (see data-layer docs).

## Current Workflow Features

- `task`: task creation/sync and module routing
- `plan`: plan build/review/format and branch merge
- `module`: build/test loop and module report maintenance

## Orchestrators and Agents

Each workflow feature folder contains:

- orchestrator files (control logic)
- `agents/` subfolder (single-purpose LLM workers)

Examples:

- `create_task` orchestrates task flow
- `create_plan` orchestrates build/review/format
- `create_module` orchestrates build/test loop

## Related Files

- Rules for this layer: workflow-layer rules
- System overview: general docs
