# Mosaic Orchestrator

Agent orchestration service for Mosaic Stack.

## Overview

The Orchestrator is the execution plane of Mosaic Stack, responsible for:
- Spawning and managing Claude agents
- Task queue management (Valkey-backed)
- Agent health monitoring and recovery
- Git workflow automation
- Quality gate enforcement callbacks
- Killswitch emergency stop

## Architecture

Part of the Mosaic Stack monorepo at `apps/orchestrator/`.

Controlled by `apps/coordinator/` (Quality Coordinator).
Monitored via `apps/web/` (Agent Dashboard).

## Development

```bash
# Install dependencies (from monorepo root)
pnpm install

# Run in dev mode
pnpm --filter @mosaic/orchestrator dev

# Build
pnpm --filter @mosaic/orchestrator build

# Test
pnpm --filter @mosaic/orchestrator test
```

## Configuration

See `.env.example` for required environment variables.

## Documentation

- Architecture: `/docs/ORCHESTRATOR-MONOREPO-SETUP.md`
- API Contracts: `/docs/M6-ISSUE-AUDIT.md`
- Milestone: M6-AgentOrchestration (0.0.6)