Skip to content
This repository was archived by the owner on Aug 11, 2025. It is now read-only.

Conversation

serithemage
Copy link
Contributor

Description

Significantly enhances the CLAUDE.md file to provide comprehensive guidance for future Claude Code instances working in this repository.

Key Changes

  • Enhanced Development Commands: Added specific test commands for single files, E2E testing with Playwright, watch mode, coverage, and formatting commands
  • Detailed Architecture Documentation: Expanded Clean Architecture explanation with complete Entity → Repository → UseCase → Controller → Handler flow
  • Naming Conventions & Branching Strategy: Added comprehensive naming rules for files, directories, components, and Git branching strategy with GitHub Issues integration
  • Integrated Development Rules: Consolidated rules from Cursor IDE (.cursor/rules/) and Windsurf (global_windsurf_rules.md) configurations
  • Technology Stack Information: Added precise version information for all dependencies and tools
  • Common Development Workflows: Added practical examples for testing specific components, debugging, and development processes
  • Important References: Added references to design documentation and IDE rules integration

Technical Details

  • Commands Added: Single file testing, E2E commands, watch mode, coverage testing, specific CDK deployment commands
  • Architecture Enhancement: Detailed Clean Architecture layers with directory structure mapping
  • Branching Strategy: GitHub Issues integration with format <type>/<issue-number>-<description>
  • Commit Standards: Enhanced with issue references and detailed examples
  • Version Information: Node.js v22.x, React v19.x, TypeScript v5.7.x/5.8.x, and all major dependencies

Impact

This enhancement will significantly improve the productivity and consistency of future Claude Code instances by providing:

  • Clear development standards and best practices
  • Comprehensive command reference for all common development tasks
  • Consistent naming and branching strategies across the project
  • Integration with existing IDE rules and development workflows
  • Complete technology stack reference for version management

Testing

  • Documentation is consistent with actual project structure
  • All referenced commands verified against existing package.json files
  • Integration with existing .cursor/rules/ and global_windsurf_rules.md confirmed
  • Pre-commit hooks pass successfully
  • Branching strategy follows new GitHub Issues integration format

Files Modified

  • CLAUDE.md: Comprehensive enhancement (394 insertions, 21 deletions)

Closes #2

Major enhancements to CLAUDE.md including:
- Enhanced development commands with specific test, E2E, and formatting commands
- Detailed Clean Architecture documentation with complete layer descriptions
- Comprehensive naming conventions for files, directories, and code elements
- GitHub Issues integrated branching strategy with detailed workflow
- Consolidated development rules from Cursor IDE and Windsurf configurations
- Technology stack information with precise version numbers
- Common development workflows with practical examples
- Important references to design documentation and IDE rules integration

This update provides future Claude Code instances with comprehensive guidance
for consistent development practices and improved productivity.

Related to #2
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Enhanced CLAUDE.md with comprehensive development guidelines

1 participant