diff --git a/.cursor/rules/conventional_commits.mdc b/.cursor/rules/conventional_commits.mdc
index f17453a0c7..010e36430b 100644
--- a/.cursor/rules/conventional_commits.mdc
+++ b/.cursor/rules/conventional_commits.mdc
@@ -1,3 +1,8 @@
+---
+alwaysApply: false
+description: how to write commit and PR titles
+---
+
 ## Conventional Commits (REQUIRED)
 
 All commit messages and PR titles MUST follow conventional commit format:
@@ -11,7 +16,7 @@ All commit messages and PR titles MUST follow conventional commit format:
 - `feat:` - New features
 - `fix:` - Bug fixes  
 - `refactor:` - Code refactoring
-- `doc:` - Documentation
+- `docs:` - Documentation
 - `style:` - Code style/formatting
 - `perf:` - Performance improvements
 - `test:` - Testing changes
@@ -29,4 +34,4 @@ chore(deps): update Rust dependencies
 ```
 
 ### Common Scopes
-`registry`, `aqua`, `cli`, `config`, `backend`, `tool`, `env`, `task`, `api`, `ui`, `core`, `deps`, `schema`, `doctor`, `shim`, `security`
\ No newline at end of file
+`registry`, `aqua`, `cli`, `config`, `backend`, `tool`, `env`, `task`, `api`, `ui`, `core`, `deps`, `schema`, `doctor`, `shim`, `security`