Menú
Investigate an API issue using logs, DB queries, and generation traces
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Use when bringing the harness method to a NEW or non-sentropic repo — maps the repo's conventions into a harness profile so the same scope/branch/verify kernel applies anywhere.
Use before any creative/design work (a feature, a package, an evolution) — explores intent and design via the spec-ladder with multi-peer adversarial review BEFORE implementation.
Use on any bug, test failure, or unexpected behaviour BEFORE proposing a fix — runs the generic evidence-first root-cause loop.
Use when you have a spec/decisions and need an executable plan — writes a lot-based BRANCH.md from the template and completes with track for realization state.
Use when completing a feature, a design step, or before merging — runs a ≥2-peer consensus review and reconciles the findings, instead of a single rubber-stamp pass.
Use when adding or evolving tests for a feature/bugfix — applies the sentropic test-pyramid, scoped-test loop, environment isolation, and AI-flaky policy.
| name | debug-api |
| description | Investigate an API issue using logs, DB queries, and generation traces |
| paths | api/src/** |
| allowed-tools | Read Bash Grep Glob |
make logs-api 2>&1 | grep -i "error\|warn\|fail" | tail -20
make db-statusmake db-query QUERY="SELECT ... LIMIT 5"make db-query QUERY="SELECT id, session_id, event_type, created_at FROM chat_generation_traces ORDER BY created_at DESC LIMIT 10"make db-query QUERY="SELECT sequence, event_type, created_at FROM chat_stream_events WHERE stream_id='<id>' ORDER BY sequence"curl -s http://localhost:${API_PORT:-8787}/api/v1/health | jq .
chat_stream_events sequence gapschat_generation_traces for raw payloadmake test-api-endpoints SCOPE=<test-file> ENV=test-<branch>