Project AGENTS Router

Root AGENTS.md is routing + cross-domain policy only. Do not place backend/frontend implementation details here.

Scope

Applies to repository root and cross-domain tasks.
Subdomain rules: backend/AGENTS.md, apps/AGENTS.md.
If rules conflict, use the stricter one.

Rule Order

System / developer / platform safety instructions
Workspace runtime rules (AGENTS.md + rules/*)
This file (routing + project-level constraints)
Subdomain rules (backend/apps)

Mandatory Routing

backend/** must follow backend/AGENTS.md.
apps/** must follow apps/AGENTS.md.
Cross-domain changes must satisfy all relevant subdomain rules.
infra/** follows this file plus infra/ conventions.

Project-Wide Constraints

Default development branch is dev; do not develop directly on main.
Never push unless explicitly requested by the user.
Keep AGENTS layered and lean: shared rules at root, domain rules in sub-AGENTS.
No Error Swallowing: All exceptions must propagate or be converted to typed errors. Never catch an exception, log it, and silently continue. This destroys debuggability.

Protocol Source of Truth

docs/protocols/ is the single source of truth for protocol and data format.

Update protocol docs before changing data/API/UI contracts.
Document compatibility strategy (backward-compatible vs migration).
Keep frontend/backend implementations aligned with documented protocol.

Database Access

When viewing data in the database, use supabase mcp tools (supabase_execute_sql, supabase_list_tables, etc.) instead of direct queries or other methods.

1.6 KiB Raw Blame History