Added Claude guidelines and GitHub actions workflow

Author: forketyfork

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Set up JDK 14
+      uses: actions/setup-java@v4
+      with:
+        java-version: '14'
+        distribution: 'temurin'
+        
+    - name: Cache Maven dependencies
+      uses: actions/cache@v4
+      with:
+        path: ~/.m2
+        key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+        restore-keys: ${{ runner.os }}-m2
+        
+    - name: Run tests
+      run: mvn clean test
+      
+    - name: Generate test report
+      uses: dorny/test-reporter@v1
+      if: success() || failure()
+      with:
+        name: Maven Tests
+        path: target/surefire-reports/*.xml
+        reporter: java-junit

CLAUDE.md

@@ -0,0 +1,53 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a demonstration project for Hibernate Extended Bytecode Enhancement, accompanying the Medium article "Hibernate Extended Bytecode Enhancement". The project shows how Hibernate's bytecode enhancement can automatically detect field changes even when they occur outside of setter methods.
+
+## Build System & Commands
+
+This is a Maven-based Java project using Java 14.
+
+### Essential Commands
+- **Build**: `mvn clean compile`
+- **Run tests**: `mvn test`  
+- **Run single test**: `mvn test -Dtest=ExtendedEnhancementTest`
+- **Clean**: `mvn clean`
+
+### Dependencies
+- Hibernate Core 5.6.15.Final
+- H2 Database 2.3.232 (for testing)
+- JUnit Jupiter 5.13.4 (for testing)
+
+## Architecture
+
+### Core Components
+
+The project demonstrates Hibernate's extended enhancement feature through:
+
+1. **Cat.java** (`src/main/java/com/forketyfork/hibernate/Cat.java`): JPA entity with:
+   - Standard getter/setter methods
+   - `myCustomMethodToChangeData()` that directly modifies the `name` field
+
+2. **SneakyCatService.java** (`src/main/java/com/forketyfork/hibernate/SneakyCatService.java`): Service that directly accesses entity fields bypassing setters via `cat.name = "Buddy"`
+
+3. **ExtendedEnhancementTest.java** (`src/test/java/com/forketyfork/hibernate/ExtendedEnhancementTest.java`): Integration test demonstrating that Hibernate can detect changes made through:
+   - Custom methods that modify fields directly
+   - External services accessing package-private fields
+
+### Hibernate Enhancement Configuration
+
+The Maven build uses `hibernate-enhance-maven-plugin` with:
+- `enableDirtyTracking=true`: Tracks which fields have been modified
+- `enableExtendedEnhancement=true`: Detects field changes even when setters aren't used
+- Version 6.6.22.Final (newer than core Hibernate for enhanced features)
+
+### Test Database Setup
+
+Tests use H2 in-memory database with Hibernate configured for:
+- Auto-create schema (`hibernate.hbm2ddl.auto=create-drop`)
+- SQL logging enabled (`hibernate.show_sql=true`)
+
+The test verifies that field modifications are properly persisted regardless of how they're made, demonstrating the power of extended bytecode enhancement.