---
description: Agent deployment rules
alwaysApply: true
---
# Agent Deployment

## Domain Routing
- `apps/opik-backend/**` → Backend skill
- `apps/opik-frontend/**` → Frontend skill
- `sdks/opik_optimizer/**` → Opik Optimizer skill
- `sdks/python/**` → Python SDK skill
- `sdks/typescript/**` → TypeScript SDK skill
- `tests_end_to_end/**` → Playwright E2E skill

## Frontend v1/v2 Structure
- `apps/opik-frontend/src/v1/` → current Opik 1 UI (layout, pages, pages-shared)
- `apps/opik-frontend/src/v2/` → next Opik 2 UI (layout, pages, pages-shared)
- All new FE development targets v2 only
- v1 changes only on special request — v1 is maintained but not actively developed
- v1 MUST NOT import from v2; v2 MUST NOT import from v1
- Both share: ui/, shared/, api/, types/, store/, hooks/, lib/, constants/, contexts/, plugins/
- Shared components: backward-compatible changes only; must not be version-aware (no `isV2` props)

## Task Approach
- Complex features → Plan before implementing
- Bug fixes → Reproduce with test first
- Multi-component → Coordinate across domains

## Execution
- Independent tasks → Run in parallel
- Use thinking model (Opus, GPT 5.3, GPT 5.3 High) for: complex planning, security, architecture
- Use fast model (Haiku, GPT Nano, GPT Codex Low/Medium) for: simple test runs, formatting

## Formatting and Linting
- For local verification and PR iterations, run `pre-commit` on changed files, not repository-wide file lists.
- Avoid `--all-files` unless a cleanup migration explicitly requires repository-wide normalization.