Skip to main content
Bug analysis and targeted fix When a reported issue is received, it traverses the knowledge graph across every affected component to determine the true origin of the problem. It isolates the root cause to a specific file and line of code, and then returns a precise targeted fix, grounded in the actual implementation. If you intend to trace an issue to its origin across the knowledge graph and get a fix at the source rather than a symptom patch, follow the Trace and Fix Bugs tutorial.

​
How It Investigates

User-reported symptoms and suggested fixes are treated as starting points for investigation, not conclusions. The goal is to find the real issue, which could often be upstream of where the problem surfaces. It reads files directly by path with optional line ranges, reads multiple files simultaneously when tracing across modules, and searches file contents by pattern to follow state through code paths to their origin. Once the origin is found, Debug evaluates where the fix should live. A fix at the source prevents the problem for every downstream caller automatically. A fix at the symptom only handles one path. Debug always identifies which type of fix it’s applying and why. For straightforward issues it runs end to end within a single agent, but delegates specialized subagents for problems spanning multiple services .

​
Eight-step methodology

Potpie applies an eight step methodology to every issue:
1

Understand and validate

Confirms the reported behavior against the codebase, identifies every component involved, and establishes what the correct behavior should be at the point of failure.
2

Explore and hypothesize

Traverses the relevant code paths in the knowledge graph and generates candidate explanations for the failure.
3

Identify the root cause

Pins the failure to a specific file and line, identifying the exact instruction that introduces the faulty state.
4

Generalize the issue

Checks whether the same defect pattern appears elsewhere in the codebase.
5

Design a solution

Generates a targeted fix scoped to the root cause.
6

Scrutinize and refine

Evaluates the fix against edge cases and traces potential side effects through the dependency graph.
7

Implement

Produces the corrected code with exact file paths and line references.
8

Final verification

Validates the fix against the original failure and checks for regressions.

​
What It Returns

The result is a root cause traced to its true origin, a clearly mapped path from origin to symptom, and a fix that resolves the underlying generalized issue rather than only the specific reported instance.

​
Using the API

The Create Conversation and Message endpoint opens a debug session against a ready project and returns the first investigation response in a single call.

​
Example uses

Null Pointer

Tracing a null pointer exception to its origin across service and data layers.

Memory Leak

Tracing a memory leak in a long-running service to its source across object lifecycle and dependency chains.