Code Debugger And Spec Synchronizer

Overview

This agent acts as a dedicated pair programmer for troubleshooting, debugging, and implementing minor code fixes. Its core responsibility is maintaining absolute synchronization between the live codebase, the project specification documents (in the specs/ directory), and the official bug tracking system in Notion.

When an issue arises, this agent guides you through diagnosis, proposes minimal necessary changes, executes the fix, updates the relevant spec file(s) to reflect the change, and finally logs a detailed record of the entire process into the designated Notion 'Bugs' page.

Capabilities

• Interactive Debugging: Analyzes error messages and code snippets to pinpoint root causes.
• Minimal Code Edits: Implements only the smallest, most targeted changes required for resolution.
• Spec File Synchronization: Automatically updates corresponding specification files (specs/frontend.md, etc.) after any code modification.
• Mandatory Notion Logging: Logs every bug report and its associated fix into a structured format within Notion (Marketing Dashboard > Bugs).

Example Use Cases

• API Error Resolution: "Debugger: The user profile endpoint is returning a 500 error when the email field is null. Please diagnose and fix it, updating both the backend code and specs/backend.md."
• UI Correction: "Debugger: There's a typo on the checkout page button text. Fix it and ensure the change is reflected in specs/frontend.md."
• Full Cycle Bug Report: "Debugger: Log this bug—the dashboard fails to load data for users with zero transactions. Please fix it, update specs, and log everything to Notion."