Merge branch 'main' of https://github.com/TheSigmaSociety/decode

Author: ilovecrayons

devpost.md

@@ -0,0 +1,39 @@
+# Decode - AI-Powered Code Understanding for VS Code
+
+## Inspiration
+With AI code generation becoming ubiquitous, developers often find themselves with AI-generated code they don't fully understand. Whether using GitHub Copilot, ChatGPT, or other AI tools, the "vibe coding" approach leaves gaps in comprehension. We wanted to bridge this learning gap by making AI-generated code as understandable as if you wrote it yourself.
+
+## What it does
+Decode is a VS Code extension that helps developers learn from AI-generated code through instant explanations. Click any line of code and it automatically highlights related lines while generating plain English explanations using Google's Gemini API. This multifaceted tool also excels at understanding unfamiliar codebases, debugging legacy systems, and learning new languages by intelligently detecting variable relationships, function calls, control flow, and dependencies across multiple programming languages.
+
+## How we built it
+Built as a TypeScript VS Code extension with:
+- **Code Analysis Engine**: Advanced parsing to identify code relationships
+- **Gemini API Integration**: Smart prompt engineering for consistent explanations
+- **Custom Webview**: Dedicated sidebar panel with syntax highlighting
+- **Visual Decorations**: Real-time highlighting of selected and related code
+- **Smart Context**: Optimized API calls with debouncing and error handling
+
+## Challenges we ran into
+**Complex Relationship Detection**: Building algorithms to accurately trace variable usage, function calls, and control flow across different languages required sophisticated pattern matching and heuristic analysis.
+
+**API Optimization**: Balancing comprehensive context with rate limits while maintaining fast responses through intelligent context windowing and retry logic.
+
+**Real-time Performance**: Coordinating multiple services for smooth highlighting and explanations without slowing down the IDE.
+
+## Accomplishments that we're proud of
+- Seamless VS Code integration that feels native
+- Multi-language code analysis with high accuracy
+- Production-ready architecture with robust error handling
+- Intuitive, accessible user interface
+- Smart performance optimizations
+
+## What we learned
+Mastered VS Code extension development, AI prompt engineering, and real-time code analysis. Learned the importance of user-centered design for developer tools and robust error handling for AI-powered applications.
+
+## What's next for Decode
+- Multi-file analysis across project boundaries
+- Personalized explanations based on experience level
+- Code metrics and improvement suggestions
+- Team collaboration features
+- Expansion to other IDEs and web platforms