john/tractatus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

fix: add mandatory framework startup to next session prompt

Browse source
This commit is contained in:
TheFlow 2025-10-14 13:16:09 +13:00
parent 29fa3956f9
commit 8a58d0ca9d
1 changed files with 61 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

61
NEXT_SESSION_STARTUP_2025-10-14_FAQ.md Normal file
View file

@ -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