From a7f171234b332256a2a9960879eca113fccdecc8 Mon Sep 17 00:00:00 2001
From: petrisorcoderabbit <petrisor@coderabbit.ai>
Date: Fri, 22 Mar 2024 01:49:30 +0200
Subject: [PATCH 1/2] Add packages section and update existing docs for
 ast-grep

---
 docs/guides/prompt-customization.md | 61 +++++++++++++++++++++++++++--
 1 file changed, 58 insertions(+), 3 deletions(-)

diff --git a/docs/guides/prompt-customization.md b/docs/guides/prompt-customization.md
index f270bd23..cf2c8ce5 100644
--- a/docs/guides/prompt-customization.md
+++ b/docs/guides/prompt-customization.md
@@ -73,6 +73,8 @@ By default, you can add `ast-grep` rules by following these steps:
    review process.
 5. Add the rules' directory to the `.coderabbit.yml` file under `tools.ast-grep`
    configuration.
+6. Optionally, you can add `packages` property to the configuration to specify
+   the packages that should be installed before running the `ast-grep` tool. Please read the `packages` section for detailed information.
 
 ```yaml
 #...
@@ -80,7 +82,10 @@ reviews:
   #...
   tools:
     ast-grep:
-      rules_directory: "custom-name"
+      rule_dirs: 
+        - "custom-name"
+      packages: 
+        - "ast-grep-essentials" # default package installed
   #...
 ```
 
@@ -247,14 +252,23 @@ my-awesome-project   # project root
 > Also, you need to add the `rules` and `utils` directories to the
 > `.coderabbit.yml` file under `tools.ast-grep` configuration.
 
+> The rules can also be inside a package. If you have a package that contains
+  rules, you can add the package name to the `packages` field in the
+  `.coderabbit.yml` file.
+
 ```yaml
 #...
 reviews:
   #...
   tools:
     ast-grep:
-      rules_directory: "rules"
-      utils_directory: "utils"
+      rule_dirs: 
+        - "rules"
+      util_dirs: 
+        - "utils"
+      packages:
+        - "ast-grep-essentials"
+        - "my-awesome-org/my-awesome-package" # public repository that contains ast-grep rules
   #...
 ```
 
@@ -276,6 +290,47 @@ rule:
 > Official documentation guide on
 > [Utility Rule](https://ast-grep.github.io/guide/rule-config/utility-rule.html)
 
+### Packages
+A package is what allows you to share rules across multiple projects. Essentially a package is a collection of ast-grep rules.
+
+Coderabbit provides a set of packages that you can use out of the box. You can also create your own packages and share them with the community or just
+use them within your organization.
+
+Packages provided by Coderabbit are:
+- `ast-grep-essentials`: A set of essential security rules
+
+To use a package, you need to add the package name to the `packages` field in the `.coderabbit.yml` file.
+
+```yaml
+#...
+reviews:
+  #...
+  tools:
+    ast-grep:
+      packages:
+        - "ast-grep-essentials"
+  #...
+```
+
+#### Using custom package
+Let's say that you have a public repository that contains ast-grep rules. You can add the package name to the `packages` field in the `.coderabbit.yml` file.
+
+Requirements for a package:
+- should be a public repository
+- contains rules that follows the ast-grep rule format
+- package name should be in the format `organization/repository`
+
+```yaml
+#...
+reviews:
+  #...
+  tools:
+    ast-grep:
+      packages:
+        - "my-awesome-org/my-awesome-package"
+  #...
+```
+
 ### Multiple Languages Support
 
 CodeRabbit supports multiple programming languages for defining `ast-grep`

From 62f10dbe8348d3407e0d5896657e6c0d910a2979 Mon Sep 17 00:00:00 2001
From: petrisorcoderabbit <petrisor@coderabbit.ai>
Date: Fri, 22 Mar 2024 02:00:06 +0200
Subject: [PATCH 2/2] Fix typos

---
 docs/guides/prompt-customization.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guides/prompt-customization.md b/docs/guides/prompt-customization.md
index cf2c8ce5..392dec30 100644
--- a/docs/guides/prompt-customization.md
+++ b/docs/guides/prompt-customization.md
@@ -291,7 +291,7 @@ rule:
 > [Utility Rule](https://ast-grep.github.io/guide/rule-config/utility-rule.html)
 
 ### Packages
-A package is what allows you to share rules across multiple projects. Essentially a package is a collection of ast-grep rules.
+A package is what allows you to share rules across multiple projects. Essentially, a package is a collection of ast-grep rules.
 
 Coderabbit provides a set of packages that you can use out of the box. You can also create your own packages and share them with the community or just
 use them within your organization.
@@ -317,7 +317,7 @@ Let's say that you have a public repository that contains ast-grep rules. You ca
 
 Requirements for a package:
 - should be a public repository
-- contains rules that follows the ast-grep rule format
+- contains rules that follow the ast-grep rule format
 - package name should be in the format `organization/repository`
 
 ```yaml