# ZoneGaze Flow User Guide

ZoneGaze Flow is a local control surface for coordinating coding agents. It gives you a board for tasks, a runtime for launching agents, isolated worktrees for safe execution, and review tools for inspecting changes before you ship.

This folder is the website-ready documentation package. It uses relative links and local media assets so it can be copied into a documentation site, CMS, or static-site generator.

## Start Here

- [Getting started](./getting-started.md)
- [Install and launch](./install.md)
- [Core workflow](./core-workflow.md)
- [Agent setup](./agent-setup.md)
- [Review and ship](./review-and-ship.md)
- [Platform notes](./platforms.md)
- [Troubleshooting](./troubleshooting.md)
- [Media gallery](./media-gallery.md)
- [Media status](./media-status.md)

## Quick Tour

Use ZoneGaze Flow when you want an agent to work on a real project without losing control of scope, review, or Git state.

1. Add or select a project.
2. Create a work item on the board.
3. Choose the agent, work type, base branch, and review behavior.
4. Start the task and watch progress in the card, terminal, or task detail view.
5. Review diffs and Git state.
6. Commit, open a PR, move the task to Done, or archive it.

[Watch the first-task walkthrough](./assets/videos/web-first-task-walkthrough.webm)

<video controls src="./assets/videos/web-first-task-walkthrough.webm" title="ZoneGaze Flow first task walkthrough"></video>

![ZoneGaze Flow board with an example work item](./assets/screenshots/web-board-overview.png)

## Main Concepts

- Projects: local repositories or workspaces that ZoneGaze Flow can open, inspect, and run against.
- Work items: cards that describe a task, story, subtask, or coordinator-style plan.
- Agents: local or connected coding agents that can work from the task prompt.
- Worktrees: isolated Git workspaces used for task execution when available.
- Review: the diff, file, terminal, and Git surfaces you use before shipping work.

## Who This Is For

ZoneGaze Flow is built for developers, technical leads, and operators who supervise one or many coding agents. It is most useful when you want parallel agent work without losing the human review loop.

## What To Read Next

If you are new, start with [Getting started](./getting-started.md). If you already have the app installed, go straight to [Core workflow](./core-workflow.md).
