nomadcode/docs/monorepo.md

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/mobile owns the Flutter-first product UI across mobile, desktop, and optional web targets.
• apps/web is the previous React/Vite console scaffold and is slated for removal or isolation from the product path.
• packages/contracts owns schemas shared across clients and services.
• agent-ops owns root agent routing, domain rules, and repeatable task workflows.

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.