docs: add clear pre-merge todos for next session

- Add prioritized todo list to CLAUDE.md for immediate visibility
- Update Next Steps with pre-merge and post-merge task separation
- Include unit testing for JSON parsing as high priority
- Add error boundaries and performance metrics to task list
- Clear guidance for completing v0.4 before merge to main

Author: evolsb

CLAUDE.md

@@ -2,6 +2,40 @@
 
 This file provides crucial guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## 🎯 NEXT SESSION TODOS (Pre-merge to main)
+
+**HIGH PRIORITY - Complete these before merging to main:**
+
+1. **Test JSON parsing fix** 
+   - Run query on https://ask-intercom-production.up.railway.app/
+   - Verify structured output instead of sparse "X customers, Y%" results
+   - Check logs if issues: `/api/logs?lines=50`
+
+2. **Add unit tests for structured JSON parsing**
+   - Test `_cleanup_json_response` method in `src/ai_client.py`
+   - Test various malformed JSON scenarios
+   - Test successful parsing of valid responses
+
+3. **Add React error boundaries**
+   - Create ErrorBoundary component
+   - Wrap main App component
+   - Show user-friendly error messages
+
+4. **Add basic performance metrics**
+   - Track query response times
+   - Log to structured logs
+   - Add to `/api/debug` endpoint
+
+5. **Integration test the full flow**
+   - Test with real API keys locally
+   - Verify Docker deployment works
+   - Confirm Railway deployment matches local
+
+6. **Final verification**
+   - All tests passing
+   - Documentation accurate
+   - Ready for v0.4 merge to main
+
 ## 🚀 Quick Start for New Claude Sessions
 
 **⚠️ MANDATORY FIRST STEP - DO NOT SKIP:**

docs/05-Next-Steps.md

@@ -112,9 +112,16 @@
 
 ### Immediate Next Session Planning
 1. ✅ **Railway deployment**: Live at https://ask-intercom-production.up.railway.app/
-2. **Template marketplace**: Package and submit to Railway templates
-3. **User testing**: Share hosted URL with target personas for feedback
-4. **Performance monitoring**: Use Railway metrics and remote debugging tools
+2. **Pre-merge tasks** (HIGH PRIORITY):
+   - Test JSON parsing fix with real query on live app
+   - Add unit tests for structured JSON parsing
+   - Add error boundaries to React frontend
+   - Add basic performance metrics collection
+   - Verify all improvements work end-to-end
+3. **Post-merge tasks** (MEDIUM PRIORITY):
+   - Create Railway template for marketplace
+   - User testing and feedback collection
+   - Performance monitoring dashboard
 
 ### 🔧 Remote Debugging (Production)
 **Critical for monitoring live deployment:**