# Repository And Package Guide

This repository is a Matrix workspace. The directory names still reflect earlier Flow-focused
history, but the current codebase is organized around host boundaries, plugin boundaries, shared
contracts, and platform shells.

## Top-Level Areas

- `docs/`: stable docs, architecture notes, manuals, and generated reference indexes.
- `plugins/`: first-party plugin packages plus upstream source mirrors and adapter notes.
- `flow/`: historical workspace name that now contains shared runtime/web/contracts foundations and
  the Flow plugin implementation.
- `platforms/`: Matrix host shells, packaging, and runtime helpers for desktop, Android, and
  service adoption.
- `test/`: durable automated tests.
- `zonegaze/memory/`: durable project memory and agent operating rules.

## Package-Level Reading Order

- `flow/README.md`: what still lives in the historical `flow/` workspace.
- `flow/common/README.md`: shared pure plugin-service helpers.
- `flow/contracts/README.md`: shared browser/runtime/platform/plugin contracts.
- `flow/runtime/README.md`: local runtime and host control plane.
- `packages/cline-sdk/README.md`: official Cline SDK boundary package.
- `plugins/README.md`: plugin package contract and current plugin map.
- `platforms/README.md`: host shell packages.
- `platforms/server-manager/README.md`: managed local server lifecycle helper.

## Boundary Rules

- Matrix host code owns shell surfaces, platform lifecycle, port visibility, and plugin composition.
- Plugin packages own their product source, docs, tests, assets, and adapters.
- Shared packages own typed contracts and reusable provider-neutral helpers.
- Upstream source mirrors stay isolated and read-only except for intentional refresh work.

## Reference Docs

- [Architecture index](../architecture/README.md)
- [Plugins](../plugins/README.md)
- [Reference hub](../reference/README.md)
- [Generated inventory](../reference/generated/inventory.md)
