debug-agent

Install the dbga debugger CLI and report toolchain readiness for Python, Go, and Node

Use when a task is primarily Python — writing, reviewing, refactoring, optimizing, or debugging Python code; building or fixing CLIs, async/asyncio services, FastAPI/Django/Flask APIs, data pipelines, or scripts; adding type hints or reaching mypy --strict; investigating Python errors (TypeError, ValueError, ImportError, AttributeError, tracebacks), hangs, or wrong output in a .py program. Keywords: Python, def, class, async/await, asyncio, dataclass, Protocol, type hints, mypy, ruff, uv, pytest, pydantic.

Use when a coding task spans design, multiple files, or more than one language and needs orchestration — decomposing the work, deciding cross-cutting architecture, then driving an evidence-first design→build→debug→verify loop. Use as the main-thread lead that delegates language work to python-expert, go-expert, or node-expert. Use for hard bugs that need runtime evidence gathered before a fix.

Use when writing, reviewing, optimizing, or debugging Go — concurrent systems (goroutines, channels, select, sync, context, errgroup), microservices, CLI tools, gRPC/REST APIs, generics, idiomatic error handling. Symptoms/keywords: data race, deadlock, goroutine leak, nil-pointer panic, "race detected", "all goroutines are asleep - deadlock", go.mod, go test -race, golangci-lint, govulncheck, dlv, slow/high-allocation Go code needing pprof.

Use when implementing, reviewing, or fixing Node.js or TypeScript code — TS type errors (TS2322/TS2345, "not assignable", strict-mode), tsconfig/build issues, async/await and unhandled-promise bugs, `Cannot read properties of undefined`, EventEmitter/stream/worker code, Express/Fastify/npm backends, Vitest/Jest tests, or plain-JS (no types) work. Keywords: typescript, ts, node, esm, async, promise, generics, vitest.

Evidence-first debugging for Python, Go, and Node.js/TypeScript — use when a program crashes, hangs, returns wrong output, or you need to inspect live runtime state. Drives the `dbga` tool (traceback localization, crash triage, stateful DAP sessions, log scanning, reversible source probes, VS Code collab).

Use when writing, reviewing, or fixing Go code — goroutines, channels, select, sync, context, errgroup; data races, deadlocks, goroutine leaks; error wrapping with %w, errors.Is/As, sentinel and typed errors; interfaces, generics, functional options; go.mod, go test -race, go vet, golangci-lint, govulncheck, dlv. Symptoms: "race detected", "all goroutines are asleep - deadlock", panic, leaking goroutines, nil-pointer deref.

Use when writing, reviewing, or fixing Node.js or TypeScript code — type errors (TS2322, TS2345, "is not assignable"), `tsconfig`/strict-mode issues, async/await bugs, unhandled promise rejections, `Cannot read properties of undefined`, EventEmitter/stream/worker code, npm/pnpm/Express/Fastify backends, Jest/Vitest tests, or plain-JS (no types) work. Keywords: typescript, ts, node, esm, async, promise, generics, vitest, jest.

Use when writing, reviewing, refactoring, or debugging Python — modules, packages, CLIs, async/asyncio code, FastAPI/Django/Flask services, data pipelines, or scripts. Triggers on Python keywords (def, class, async/await, asyncio, dataclass, Protocol, type hints, mypy, ruff, uv, pytest, pydantic), Python errors (TypeError, ValueError, ImportError, AttributeError, tracebacks), and tasks like "write/fix/optimize Python", "add type hints", "make this async", "Pythonic", ".py file".