# Monorepo Layout

The workspace is organized by runtime boundary rather than by task.

- `services/core` owns orchestration, persistence, scheduling, and external model/service adapters.
- `apps/client` owns the Flutter-first product UI across mobile, desktop, and optional web targets.
- `apps/web` was the previous React/Vite console scaffold, which has been removed as part of the Flutter-first client consolidation.
- `packages/contracts` owns schemas shared across clients and services.
- `agent-ops` owns root agent routing, domain rules, and repeatable task workflows.
- `docs/test-environments.md` records shared verification environments such as the remote Android SDK runner.

Keep feature work scoped by domain, but land cross-boundary changes in one branch when API contracts, generated clients, and UI behavior must move together.