🐞 Bug Whisper: Debug Smarter, Not Harder

🔮 Inspiration

As developers, we spend countless hours chasing down cryptic error messages, from ReferenceError: total is not defined to frustrating build failures. Debugging often feels more like whispering to our code, hoping it reveals what went wrong. That’s where the idea for Bug Whisper came from — an AI-powered debugging partner that not only fixes issues but also teaches you why the fix works.

🛠️ What We Built

Bug Whisper is an AI-powered tool that helps developers:

• 🧩 Detect common coding errors automatically.
• ✨ Suggest fixed code instantly (instead of repeating the bug).
• 📖 Explain why the bug happened in clear language.
• 🔄 Offer reusable Kiro prompts for debugging workflows.

At its core, Bug Whisper integrates with Kiro, the AI IDE, using spec-driven development and agent hooks. It listens to your code, identifies mistakes, and whispers back the clean, corrected version.

📚 What We Learned

• How to design spec-driven AI workflows inside Kiro’s /.kiro directory.
• Writing precise prompts to guide the AI towards fixes instead of mirroring buggy code.
• The importance of balancing automation with education — fixing a bug is good, but explaining it is even better.
• Collaborative debugging is not just faster, it’s more fun 🚀.

🚧 Challenges We Faced

• ❌ Early attempts had Kiro just echoing the buggy code instead of fixing it.
• 🧠 Crafting the right prompts took multiple iterations — clarity matters more than verbosity.
• ⚡ Handling different bug categories (syntax, logic, runtime) required modular hooks.
• 🎥 Condensing the workflow into a 3-minute demo video while keeping it impactful.

💡 Future Plans

• Expand beyond JavaScript to Python, Java, and C++.
• Add a learning dashboard that tracks common mistakes and suggests personalized lessons.
• Create a VS Code extension so developers can debug without leaving their editor.
• Gamify debugging: earn points and badges for fixing tricky bugs.

🧾 Math Twist (Why debugging matters)

On average, developers spend up to 50% of their time debugging. If \$T_{dev}\$ is the total time coding, then:

$$ T_{debug} = 0.5 \times T_{dev} $$

Reducing debugging time even by 20% means more innovation and fewer headaches. Bug Whisper is our attempt to make that equation a little friendlier.

Built With

• fastapi)
• github
• javascript
• node.js)
• python
• react
• sqlite
• tailwindcss
• to