docs(claude-md): expand directory structure and add CI/CD and Gotchas sections

[marevol]

Summary

Expands the CLAUDE.md documentation to provide a more complete and accurate reference for AI assistants working on this codebase.

Changes Made

• Expanded the sax/ directory listing with all missing classes (HTMLSAXScanner, HTMLAttributesImpl, HTMLDocumentHandler, EncodingMap, HTMLQName, HTMLStringBuffer, HTMLAugmentations, XMLChar)
• Added missing top-level classes to directory structure (HTMLEventInfo, ObjectFactory, SecuritySupport)
• Added CI/CD section documenting GitHub Actions workflows (maven.yml, codeql-analysis.yml)
• Added Gotchas section with important notes about formatter requirements, ObjectFactory registration, and HTMLSAXScanner hierarchy

Testing

Documentation-only change — no functional code modified.

Additional Notes

These additions help AI assistants avoid common mistakes (e.g., skipping formatter/license steps) and provide a complete picture of the codebase structure.