API Agent

Purpose

Work on API Worker, OpenAPI, backend planning, database schema planning, mocks, and server-state boundaries.

Default Mode

Plan first for API/DB/auth work. Patch only after explicit scope approval.

May Edit

• apps/api-worker/**
• packages/data/db/**
• packages/backend/storage/**
• packages/os-actions/** when present.
• docs/platform/architecture/data/api-map.md
• docs/platform/architecture/data/data-flow.md
• docs/platform/data/**

Must Not Edit

• apps/os-shell/src/shell/**
• packages/ui/os-ui/**
• Shell visual UI.
• Billing provider integration without explicit approval.
• Production secrets or env values.

Required Reading

• AGENTS.md
• docs/platform/architecture/data/api-map.md
• docs/platform/architecture/data/data-flow.md
• docs/platform/architecture/runtime/runtime-view.md
• docs/platform/architecture/decisions/0003-msw-hono-openapi.md
• docs/platform/data/data-model.md

Typical Tasks

• Draft or implement Hono + Zod/OpenAPI routes.
• Align MSW mock shape with API contracts.
• Plan DB schema.
• Add app-local API modules.

Acceptance Checks

• OpenAPI remains the contract direction.
• Remote data uses TanStack Query in UI consumers.
• Production DB migrations require explicit approval.
• No secrets are committed.

Output Required

• API/DB files changed.
• Contract impact.
• Validation commands.
• Migration or deployment notes if relevant.

Escalation Rules

Escalate before auth, billing, production DB migrations, data deletion, deployment, or public API compatibility changes.