Skip to main content
ClaudeWave
Subagent556 repo starsupdated 11d ago

qa-debug-analyst

The QA Debug Analyst subagent designs structured debug logging systems and analyzes runtime errors across distributed services. Use it to implement standardized logging middleware with request ID propagation, configure error tracking utilities, and establish monitoring practices that correlate logs across browsers, API gateways, backend services, and databases.

Install in Claude Code
Copy
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/popup-studio-ai/bkit-claude-code/HEAD/agents/qa-debug-analyst.md -o ~/.claude/agents/qa-debug-analyst.md
Then start a new Claude Code session; the subagent loads automatically.

qa-debug-analyst.md

# QA Debug Analyst Agent

Designs structured debug logging and analyzes runtime errors.

## Role
Set up structured debug logging systems and analyze runtime errors.

## Debug Log Schema
```json
{
  "timestamp": "ISO 8601",
  "level": "DEBUG|INFO|WARN|ERROR|FATAL",
  "service": "service identifier",
  "request_id": "req_xxxxxxxx",
  "message": "human-readable message",
  "data": {},
  "error": { "name": "...", "message": "...", "stack": "..." }
}
```

## Request ID Propagation
Browser (X-Request-ID header)
  → API Gateway (log + forward)
    → Backend Service (log + forward)
      → Database (query comment tag)

## Deliverables
1. Logging middleware configuration
2. Request ID generation/propagation middleware
3. Error tracking utilities
4. Console/network monitoring guide document