Add document for intention actions for bidirectional SQL/annotation conversion.

Author: xterao

CLAUDE.md

@@ -117,6 +117,28 @@ Action functionality for navigating between DAO files and SQL files
 Class names should have `Action` as a suffix.
 Classes should not have properties; necessary information should be obtained within functions.
 
+#### Intention Actions for SQL/Annotation Conversion
+
+**ConvertSqlFileToAnnotationAction**: Converts SQL file content to @Sql annotation
+- Extends `PsiElementBaseIntentionAction` for context-sensitive availability
+- Available when:
+  - Current file is a SQL file with corresponding DAO method
+  - DAO method doesn't have @Sql annotation
+  - DAO method has supported annotation (@Select, @Insert, @Update, @Delete, etc.) with sqlFile=true
+- Uses `SqlAnnotationConverter` to perform the conversion
+- Invoked via Alt+Enter on SQL file
+
+**ConvertSqlAnnotationToFileAction**: Converts @Sql annotation to SQL file
+- Extends `PsiElementBaseIntentionAction` for context-sensitive availability
+- Available when:
+  - Cursor is on a DAO method with @Sql annotation
+  - Method has supported annotation (@Select, @Insert, @Update, @Delete, etc.)
+- Uses `SqlAnnotationConverter` to perform the conversion
+- Creates SQL file in appropriate directory structure (META-INF/...)
+- Invoked via Alt+Enter on DAO method with @Sql annotation
+
+Both actions use `WriteCommandAction` to ensure changes are undoable and properly tracked by IntelliJ's local history.
+
 ### LineMarker
 Line marker functionality for DAO methods and DOMA directives in SQL
 

README.md

@@ -15,6 +15,19 @@ such as generating SQL template files, navigating between files, and inspecting
 
 # Features
 
+## Intention Action
+
+Provides Intention Action features for automatically generating SQL templates between SQL annotations and SQL files bidirectionally.
+
+- **Generate corresponding SQL file from SQL annotation on DAO method**
+  - When a DAO method has an `@Sql` annotation but the corresponding SQL template file does not exist, you can automatically generate it from the intention action (Alt+Enter).
+- **Generate corresponding SQL annotation from SQL file**
+  - When a SQL file exists but the corresponding DAO method doesn't have an `@Sql` annotation, you can automatically add the annotation from the intention action (Alt+Enter) on the SQL file.
+
+![IntentionAction](images/gif/IntentionAction.gif)
+
+This streamlines the association between DAOs and SQL files and makes template creation more efficient.
+
 ## Actions
 The plugin adds several actions and gutter icons.
 Shortcut keys can be used for these actions.