Debug Logging Assistant

Quick start

• Read the target code and recent failures to understand where visibility is missing.
• Add debug logs only where they help explain flow, inputs, branching, or error context.
• Keep logs small and descriptive: what is happening, key identifiers, and outcomes.
• Do not change control flow or data; only add logs. Avoid logging every step.
• See references/logging_rules.md for placement and messaging guidelines.

Workflow

1. Inspect

   • Identify high-signal spots: entry points, external calls, branching paths, retries, and error handling.
   • Note important identifiers (IDs, counts, feature flags) that disambiguate paths.

2. Place logs

   • Log before/after risky operations and around decisions that affect downstream behavior.
   • Prefer one concise log per logical block over multiple low-value messages.
   • Keep sensitive data out; include only safe identifiers or summaries.