# ZoneGaze Flow Plugin

## Role

First-party Matrix plugin for project orchestration, task worktrees, agent execution, review, and
Git-backed shipping.

## Source Boundaries

- Shared foundations and plugin implementation: `flow/`
- Plugin-specific behavior: `flow/product/`
- Runtime control plane: `flow/runtime/`
- Web UI: `flow/web/`

## Current Capability Signals

- Capability registry: `project-context`
- Runtime/package status: `ready`
- Catalog/runtime evidence: `flow/contracts/src/zonegaze-products.ts`, `flow/common/src/plugin-services.ts`

## Major Features

- Task board and work-item lifecycle
- PTY-backed agent sessions and native Cline SDK sessions
- Git worktree lifecycle and review diffs
- Project context and workflow settings
- Terminal panels, shortcuts, and runtime state streams

## Current Matrix Coordination

- `Git`: Flow owns task/worktree/review workflow while Git exposes shared repository and device
  actions through the same project state.
- `Code`: start work in Flow, open the same repository in Code to implement it, then return to Flow
  for review and shipping.
- `Chat`: Chat can attach Flow project context and show the real Flow agent panel when a project
  agent is available.
- `Joplin` and `Open Design`: Matrix already routes current project identity/context from the Flow
  side of the system into those plugin surfaces.
- `Research`: Research can already store evidence against a project scope; broader automatic Flow
  linking is still evolving.

## Related Docs

- [Flow manual](../manual/software-manual.md)
- [Flow feature catalog](../features/feature-catalog.md)
- [Runtime API](../reference/runtime-api.md)
- [Matrix plugin coordination](plugin-coordination.md)
