tractatus/NEXT_SESSION_STARTUP_2025-10-14_FAQ.md

1.9 KiB

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