Backend Debugging Skill

Mission

Restore failing Encore.ts flows quickly by combining structured logs, targeted SQL queries, and the diagnostic script arsenal. This skill keeps the top-level procedure concise; each reference file contains deep dive playbooks.

When to Use

• encore test failures or flaky integration tests
• Stalled workers (runs stuck queued/in_progress)
• Graph projector or subscription issues
• CI regressions surfaced by task backend:test or smoke suites

Rapid Response Workflow

1. Reproduce & capture context – Re-run the failing test with encore test … and collect assertion + log data.
2. Inspect database state – Use targeted queries from references/debug-queries.md to confirm run status, events, and projector outcomes.
3. Run diagnostic scripts – Leverage the tools catalogued in references/diagnostic-scripts.md to inspect timelines, cursors, and agent snapshots.
4. Apply fix & verify – Update code, rerun tests, and document the outcome in Graphiti (include root cause + remediation).