Skip to main content

​
Projects, Tasks, and Workflows

Zenflow organizes work into a clear hierarchy that keeps every automation layer aligned and traceable.

​
Projects

Projects define the scope, repositories, and automation presets for your work. Each project contains:
  • Repository connection: Link to your Git repository
  • Automation settings: Default agents, workflows, and verification scripts
  • Kanban boards: Visual task management with customizable columns
  • Team settings: Shared configurations and access controls
Run multiple repositories simultaneously—each repo becomes its own project with tuned workflows. Even within a single repo, carve out focused projects per area or service.

​
Tasks

Tasks are the fundamental unit of work in Zenflow. Each task:
  • Runs in an isolated Git worktree for conflict-free parallel execution
  • Has a dedicated branch that tracks all changes
  • Contains workflow-specific artifacts (specs, plans, reports)
  • Supports verification gates that validate changes automatically

​
Subtasks and Chats

Live, step-aware conversations where agents plan, build, and verify while telemetry shows every command and result. You can intervene, approve, or redirect at any point.

​
Git Worktrees

Every task runs in its own isolated workspace powered by Git worktrees. This enables true parallel execution—multiple agents working simultaneously without conflicts. When you create a task:
  1. A new worktree is created at .zenflow/tasks/{task_id}
  2. A dedicated branch is created for that task
  3. Agents work in this isolated directory
  4. Changes remain separate until you merge

​
Workflows

Workflows define how tasks execute. Zenflow includes built-in workflows:
WorkflowBest For
Quick ChangeSmall, well-understood tasks
Fix BugRegressions and issue triage
Spec and BuildMedium features needing design review
Full SDDLarge initiatives with PRDs and specs
You can also create custom workflows by adding Markdown files to .zenflow/workflows/.

​
Verification

Zenflow’s quality gate ensures only passing code reaches you:
  • Automatic verification runs after each agent turn
  • Tests, builds, and security checks execute as configured
  • Multi-agent verification lets agents cross-check each other’s work
  • Fast feedback helps agents self-correct before issues accumulate

​
Next Steps

Quickstart

Get started with your first Zenflow project

Project Configuration

Set up automation scripts and environment