Skip to content

Conversation

@atomantic
Copy link
Owner

Summary

  • Reduced root CLAUDE.md from 824 to 106 lines (87% reduction)
  • Implemented scope-based context loading for better memory management
  • Created modular documentation structure

Changes

Root CLAUDE.md Optimization

  • Focused on project-wide architecture and principles only
  • Removed verbose module-specific content
  • Added clear references to detailed documentation

New Module-Specific Context Files

  • plugin/CLAUDE.md - Plugin development workflow, hot reload, Python API
  • server/CLAUDE.md - TypeScript standards, MCP server architecture

Documentation Reorganization

  • docs/unreal-engine-conventions.md - Detailed UE conventions, viewport control, coordinate system
  • docs/code-style-guide.md - Comprehensive code standards for TypeScript and Python

Benefits

  • 71% reduction in active context loaded by Claude
  • Better performance through scope-based loading
  • Clearer organization with logical content grouping
  • No information loss - all content preserved in appropriate locations

Testing

  • Verified all markdown files render correctly
  • Confirmed no critical information was lost
  • Tested that subfolder CLAUDE.md files are properly referenced

🤖 Generated with Claude Code

- Reduce root CLAUDE.md from 824 to 106 lines (87% reduction)
- Create module-specific CLAUDE.md files for plugin/ and server/
- Move detailed UE conventions to docs/unreal-engine-conventions.md
- Extract comprehensive code standards to docs/code-style-guide.md
- Implement scope-based loading for better context management

The new structure follows best practices:
- Root CLAUDE.md focuses on project-wide concerns
- Subfolder CLAUDE.md files contain module-specific context
- Detailed documentation moved to reference files
- Total active context reduced by 71% with improved organization

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Copilot AI review requested due to automatic review settings September 14, 2025 16:55
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

Restructures the project documentation for better scope management and performance by reducing the main CLAUDE.md file from 824 to 106 lines (87% reduction) and creating dedicated module-specific context files.

  • Moved module-specific content to dedicated CLAUDE.md files in server/ and plugin/ directories
  • Created comprehensive documentation files in docs/ for code standards and UE conventions
  • Maintained all original information while organizing it logically by scope and usage

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
server/CLAUDE.md TypeScript standards, MCP server architecture, and development workflow for server module
plugin/CLAUDE.md Plugin development patterns, hot reload workflow, and Python API integration guidance
docs/unreal-engine-conventions.md Detailed UE-specific conventions, viewport control, coordinate system, and best practices
docs/code-style-guide.md Comprehensive code standards for TypeScript and Python with examples and CI requirements
CLAUDE.md Streamlined project overview focusing on architecture, quick start, and cross-module principles

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@atomantic atomantic merged commit b01d4d5 into main Sep 14, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant