Workflow stages
The default plan → architect → execute → validate → review → fix → verify pipeline.
The default Vibestrate workflow: plan → architect → execute → validate → review → fix → verify. Stages are defined in src/workflow/default-workflow.ts; the per-stage prose lives in the docs generator.
Read the task and write a plan.
Planner agent reads task + project rules + skills, writes a structured plan that names the files and behaviors it intends to change.
Sketch how the plan fits into the codebase.
Architect agent expands the plan with module boundaries, data flow, and interface contracts before any code is written.
Apply the changes in an isolated git worktree.
Executor agent edits files inside the run's worktree. Edits are real - never touches the project root.
Run the project's validation commands.
Runs `commands.validate` from project.yml (typecheck, tests, build, lint). Output is recorded; failures route to fix.
Have a different agent critique the diff.
Reviewer agent compares plan to diff, reads validation output, and emits APPROVED / CHANGES_REQUESTED / BLOCKED.
Address review findings and re-validate.
Fixer agent ingests review findings + validation logs, patches the diff, then control returns to validating → reviewing.
Confirm the run is ready to merge.
Verifier agent does a final pass - checks for unresolved findings, missing tests, or untouched validation gates. Emits PASSED / FAILED / NEEDS_HUMAN.
