# Core Workflow

The core workflow is input, execution, review, and result.

## 1. Add Or Select A Project

Projects represent local repositories or workspaces. Use the sidebar to switch projects, add another project, or open the project in your editor.

![Project sidebar and board overview](./assets/screenshots/web-board-overview.png)

## 2. Create Work

Create a work item from Backlog or another planning column. The prompt should tell the agent exactly what to do and how to verify it.

![Create task composer](./assets/screenshots/web-create-task.png)

Work items can carry:

- prompt text
- work type
- parent task
- base branch or ref
- agent choice
- plan mode preference
- automatic review preference
- image attachments and file references

## 3. Choose Work Type

Use work types to express the shape of work:

- Epic for large coordinating outcomes.
- Story for user-facing slices.
- Task for ordinary implementation work.
- Subtask for small child work.

Coordinator-style work can produce or organize child tasks. Executable work is intended to be run by an agent.

## 4. Start The Task

Open the task detail view and confirm the settings before you start.

![Task detail view before start](./assets/screenshots/web-task-detail.png)

When you start a task, ZoneGaze Flow prepares the workspace and launches the selected agent. Depending on the agent and project state, it can use an isolated worktree so the task does not overwrite the main checkout.

## 5. Monitor Progress

Use the card, task detail, or terminal panel to monitor work.

![Terminal panel opened from the board](./assets/screenshots/web-terminal.png)

The terminal panel is useful for long-running commands, CLI agents, and workspace inspection. Treat terminal output as operational evidence, not final proof by itself.

## 6. Use Git History

The Git history view helps you inspect commits, branch state, and working-copy changes without leaving the app.

![Git history view](./assets/screenshots/web-git-history.png)

## 7. Archive Finished Work

After a task is complete and no longer needs active attention, move it to Done or archive it.

![Archive view](./assets/screenshots/web-archive.png)

## Workflow Video

[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 core workflow"></video>

## Next Steps

- Configure agents in [Agent setup](./agent-setup.md).
- Learn the review flow in [Review and ship](./review-and-ship.md).
