Files
claudetools/docs/testing/POST_REBOOT_TESTING.md
azcomputerguru 565b6458ba fix: Remove all emojis from documentation for cross-platform compliance
Replaced 50+ emoji types with ASCII text markers for consistent rendering
across all terminals, editors, and operating systems:

  - Checkmarks/status: [OK], [DONE], [SUCCESS], [PASS]
  - Errors/warnings: [ERROR], [FAIL], [WARNING], [CRITICAL]
  - Actions: [DO], [DO NOT], [REQUIRED], [OPTIONAL]
  - Navigation: [NEXT], [PREVIOUS], [TIP], [NOTE]
  - Progress: [IN PROGRESS], [PENDING], [BLOCKED]

Additional changes:
  - Made paths cross-platform (~/ClaudeTools for Mac/Linux)
  - Fixed database host references to 172.16.3.30
  - Updated START_HERE.md and CONTEXT_RECOVERY_PROMPT.md for multi-OS use

Files updated: 58 markdown files across:
  - .claude/ configuration and agents
  - docs/ documentation
  - projects/ project files
  - Root-level documentation

This enforces the NO EMOJIS rule from directives.md and ensures
documentation renders correctly on all systems.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 16:21:06 -07:00

2.3 KiB

Post-Reboot Testing Instructions

What Was Fixed

Commit: 359c2cf - Fix zombie process accumulation and broken context recall

5 Critical Fixes:

  1. Reduced periodic save from 1min to 5min (80% reduction)
  2. Added timeout=5 to all subprocess calls (prevents hangs)
  3. Removed background spawning (&) from hooks (eliminates orphans)
  4. Added mutex lock to prevent overlapping executions
  5. CRITICAL: Added UTF-8 encoding to log functions (enables context saves)

Expected Results:

  • Before: 1,010 processes/hour, 3-7 GB RAM/hour
  • After: ~151 processes/hour (85% reduction)
  • Context recall: NOW WORKING (was completely broken)

Testing Commands

Step 1: Capture Baseline (Immediately After Reboot)

cd D:\ClaudeTools
powershell -ExecutionPolicy Bypass -File monitor_zombies.ps1

Note the TOTAL process count - this is your baseline.


Step 2: Work Normally for 30 Minutes

Just use Claude Code normally. The periodic save will run in the background every 5 minutes.


Step 3: Check Results After 30 Minutes

cd D:\ClaudeTools
powershell -ExecutionPolicy Bypass -File monitor_zombies.ps1

Compare TOTAL counts:

  • Old behavior: ~505 new processes in 30min
  • Fixed behavior: ~75 new processes in 30min (should see this)

Step 4: Verify Context Saves Are Working

Get-Content D:\ClaudeTools\.claude\periodic-save.log -Tail 20

What to look for:

  • [OK] Context saved successfully (ID: ...)
  • NO encoding errors (no "charmap" errors)

Step 5: Test Context Recall on Restart

  1. Close Claude Code window
  2. Reopen Claude Code in ClaudeTools directory
  3. Check if context is automatically injected at the start

Expected: You should see a "Previous Context" section automatically appear without needing to ask for it.


Quick Reference

Monitoring Script: monitor_zombies.ps1 Periodic Save Log: .claude\periodic-save.log Results Log: zombie_test_results.txt (created by monitor script) Project ID: 3c1bb5549a84735e551afb332ce04947


Success Criteria

[OK] Process count increase <100 in 30 minutes (vs. ~505 before) [OK] No encoding errors in periodic-save.log [OK] Context auto-injected on Claude Code restart [OK] Memory usage stable (not growing rapidly)


DELETE THIS FILE after successful testing