Debug flow when you don't understand the code
Reproduce → read error → convex logs → typecheck/lint → smallest fix → verify build.
Difficulty 2/5
Plain English
You don't need to read every line. You need a checklist: what did you click, what error text, which repo, which deployment. Paste errors into Error Explainer in this app.
Analogy
Doctor: symptoms first, then one test at a time — not random surgery.
Jessica's wedding portal
npm run lint && npm test && npm run build — done bar in CLAUDE.md.
Agentify CRM
npm run typecheck before commit; convex logs --prod for prod bugs.
Go deeper
Error message is a clue, not noise.
Common mistakes
- Letting the agent silence errors with any.
- Skipping reproduce steps.
AI-agent trap
Claiming fixed without running the repo's verify commands.
Summary
Tenant bugs: check actor + index. UI bugs: React devtools + network tab.
Confidence: