# AGENTS.md Template For Split Backend Repo

## Repo role
- This repo owns FastAPI services, database models, auth, admin APIs, and integrations.
- It serves the storefront and admin frontend repo through explicit contracts.

## Backend scope
- Catalog, taxonomy, auth, customers, carts, orders, content, settings, and admin operations.
- Migrations, background jobs, storage, and integration boundaries.

## Contract rules
- Keep OpenAPI and schema naming stable.
- Document any breaking change for the frontend repo before implementation.

## Security and roles
- Separate customer and staff permissions.
- Apply RBAC for admin operations.

## Delivery rules
- Maintain migration safety and predictable local development.