This file is a quick orientation guide for AI agents: only non-obvious pitfalls that frequently break local runs, builds, tests, migrations, security checks, agentic flows, etc.
- Before starting a task, read this file fully.
- Keep entries minimal: one line per gotcha, focused on "symptom -> check/fix".
- Do not duplicate README/docstrings/playbooks; link to source docs instead.
- Agent-facing docs ownership:
AGENTS.mdbootstraps,.cursor/rules/holds always-on guardrails,.cursor/skills/holds role workflows,docs/prompts/holds user-run workflows, anddocs/tasks/tasks.template.jsonis the queue schema canon.