# debug (10-debug.com)

When something is going wrong, a person says they need to debug it. They mean they want to find the cause and fix it. The word comes from removing an actual bug from a machine, but now it just means troubleshooting any problem.

## What a model may hear
- run in debug mode (software development tools): switch to a mode that pauses execution, shows variables, and logs internals, which may slow performance or expose data
- remove breakpoints and logging code (programming workflows): assume the user wants to clean up instrumentation before shipping, not find new problems
- isolate a failing test case (machine learning pipelines): rerun with a single example, reduced batch size, or verbose logging to catch an error
- trace tensor values (deep learning frameworks): inject hooks to print intermediate activations and gradients

## Where people and models part ways
- Says: "Debug my essay."
  Means: Check my grammar and clarity.
  May be taken as: Try to run the text through a code debugger or look for syntax errors.
  Say instead: "Check my essay for unclear sentences and grammar mistakes."
- Says: "Debug why she is upset."
  Means: Help me understand her feelings.
  May be taken as: Treat human emotions as a system with traceable variables and breakpoints.
  Say instead: "Help me understand why she might be upset and how to talk about it."
- Says: "Debug the photo."
  Means: Fix why it looks wrong.
  May be taken as: Assume the image file is corrupted and suggest hex editors or EXIF tools.
  Say instead: "Fix the color and lighting in this photo."
- Says: "Debug the recipe."
  Means: Fix why the dish did not turn out.
  May be taken as: Treat cooking as a program with variables to inspect rather than asking about technique.
  Say instead: "Help me figure out why my cake came out dense and how to fix it."

## Tips
- Say what is broken and what you already tried.
- Mention the domain, like writing, cooking, or code.
- Ask for steps, not a mode, if you do not want technical internals.
- Say 'no technical tools' if you mean everyday problem solving.
- Use 'fix' or 'troubleshoot' when you do not want code-level detail.

## Often confused with
- trace: follow a path, not necessarily find a fault
- profile: measure performance, not find bugs
- lint: check style rules, not logic errors
- test: verify correctness, not locate failure cause
- refactor: restructure code, not fix bugs
- patch: apply a fix directly, not diagnose