debug-help

Debug Help Prompt

Purpose

Structure debugging requests to efficiently identify and resolve issues.

Pipeline Boundary (when used with the junai pipeline)

If .github/pipeline-state.json exists:

• Produce a diagnostic brief and a project-ready troubleshooting prompt.
• Do not include pipeline-stage transitions, gate instructions, or pipeline-state edits.
• Do not provide direct handoff routing.
• End with: "Use @Orchestrator to route this troubleshooting brief."

Input Required

• Error message or symptom
• Code context
• What was tried

Template

I need help debugging an issue:

## The Problem
**What's happening**: {symptom_description}

**Expected behavior**: {what_should_happen}

**Error message** (if any):

{error_message}

## Context

**File/Function**: {location}

**Relevant code**:
```python
{code_snippet}

When it happens: {trigger_conditions}

Environment:

• Python version: {version}
• OS: {os}
• Relevant packages: {packages}

What I've Tried

1. {attempt_1}
2. {attempt_2}
3. {attempt_3}

Additional Context

{any_other_info}

Please help me:

1. Identify the root cause
2. Suggest a fix
3. Explain why the issue occurred

## Example

### Input

I need help debugging an issue:

The Problem

What's happening: Dashboard crashes when loading complaints data

Expected behavior: Dashboard should display the complaints table

Error message:

pyodbc.OperationalError: ('08001', '[08001] [Microsoft][ODBC Driver 17 for SQL Server]
Named Pipes Provider: Could not open a connection to SQL Server [53]. (53)')

Context

File/Function: app/pages/dashboard.py, load_complaints_data()

Relevant code:

@st.cache_data(ttl=timedelta(minutes=15))
def load_complaints_data():
    adapter = DatabaseAdapter()
    return adapter.fetch_dataframe(
        "SELECT * FROM complaints WHERE status = 'open'"
    )

When it happens: On first page load, after recent server restart

Environment:

• Python version: 3.11.4
• OS: Windows Server 2019
• Relevant packages: pyodbc 4.0.39, streamlit 1.28.0

What I've Tried

1. Checked SQL Server is running (it is)
2. Tested connection string in SQL Server Management Studio (works)
3. Restarted the Streamlit app

Additional Context

This was working yesterday. Server was restarted overnight for updates.