diff --git a/NEXT_SESSION_STARTUP_2025-10-14_FAQ.md b/NEXT_SESSION_STARTUP_2025-10-14_FAQ.md new file mode 100644 index 00000000..88e58f15 --- /dev/null +++ b/NEXT_SESSION_STARTUP_2025-10-14_FAQ.md @@ -0,0 +1,61 @@ +# Optimal Startup Prompt for Next Session + +## Copy-Paste This: + +``` +MANDATORY FIRST STEP: node scripts/session-init.js + +Then continue from SESSION_HANDOFF_2025-10-14_FAQ_MODAL.md + +CRITICAL: FAQ modal scrollbar not visible in production (https://agenticgovernance.digital/faq.html). User blocked from accessing 20+ questions. Previous session made multiple unsuccessful attempts due to panic response. + +TASK: Diagnose modal scrollbar issue systematically BEFORE attempting any fix: + +1. Test locally at http://localhost:9000/faq.html +2. Open browser DevTools, click "View All Questions & Search" +3. Run diagnostics in console: + - Check scrollHeight vs clientHeight + - Verify FAQ count in DOM + - Check computed overflow-y + - Test programmatic scroll +4. Identify root cause +5. Implement targeted fix based on diagnosis +6. Deploy and verify with user + +Modal structure: public/faq.html:505-570 +Rendering logic: public/js/faq.js:3082-3139 + +Server running on port 9000. DO NOT PANIC - diagnose first. +``` + +--- + +## Alternative Short Prompt: + +``` +Run node scripts/session-init.js then read SESSION_HANDOFF_2025-10-14_FAQ_MODAL.md and diagnose FAQ modal scrollbar issue systematically using browser DevTools. Previous attempts failed due to panic response. Diagnose BEFORE fixing. +``` + +--- + +## Key Points for Next Claude: + +1. **Don't panic** - This is a solvable UI issue +2. **Diagnose first** - Use browser DevTools, don't guess +3. **User is frustrated** - They've reported this multiple times +4. **Modal structure exists** - Just needs proper scrollbar visibility +5. **Test locally first** - Server running on port 9000 + +--- + +## Files to Reference: + +- `SESSION_HANDOFF_2025-10-14_FAQ_MODAL.md` - Complete context +- `public/faq.html:505-570` - Modal HTML structure +- `public/faq.html:270-293` - Modal CSS styles +- `public/js/faq.js:3082-3139` - FAQ rendering + +--- + +**Date**: 2025-10-14 +**For**: Next Claude Code Session