Merge pull request #639 from linear-b/Introduce-LinearB-AI

added describe pr filter

Author: PavelLinearB

docs/automations/integrations/LinearBAI/describe-pr/LinearB-AI-describe-pr.png

@@ -0,0 +1,43 @@
+---
+title: Automation - Add PR Description Using LinearB's AI
+description: Use gitStream's integration with AI services to generate a summary of the changes in the PR.
+category: [quality, genai, copilot, tests, efficiency]
+starter_kits: [genai]
+---
+# Add PR Description Using LinearB's AI
+
+<!-- --8<-- [start:example]-->
+Use the `AI_DescribePR` filter to automatically generate and append a concise, AI-generated description to a pull request. This ensures that all PRs include meaningful and helpful descriptions, improving review efficiency.
+
+![summarized-pr](/automations/integrations/askAI/summarize-pr/LinearB-AI-describe-pr.png)
+
+!!! info "Configuration Description"
+
+    Conditions (all must be true):
+
+    * A PR is created or new code has been committed to the PR.
+
+    Automation Actions:
+
+    * Append the AI-generated description to the PR description.
+
+!!! example "Configuration Example"
+    ```yaml+jinja
+    --8<-- "docs/downloads/automation-library/integrations/LinearBAI/describe-pr.cm"
+    ```
+    <div class="result" markdown>
+        <span>
+        [:octicons-download-24: Download this example as a CM file.](/downloads/automation-library/integrations/LinearBAI/describe-pr.cm){ .md-button }
+        </span>
+    </div>
+<!-- --8<-- [end:example]-->
+
+## Additional Resources
+
+--8<-- "docs/snippets/general.md"
+
+**Related Automations**:
+
+--8<-- "docs/snippets/context-automation.md"
+
+--8<-- "docs/snippets/automation-footer.md"

docs/automations/integrations/LinearBAI/describe-pr/LinearB-AI-describe-pr.svg

@@ -2,7 +2,6 @@
 title: Automation - Ask AI to Summarize the Changes in a PR
 description: Use gitStream's integration with AI services to generate a summary of the changes in the PR.
 category: [quality, genai, copilot, tests, efficiency]
-starter_kits: [genai]
 ---
 # Ask AI to Summarize the Changes in a PR
 

docs/automations/integrations/LinearBAI/describe-pr/README.md

@@ -0,0 +1,15 @@
+manifest:
+  version: 1.0
+
+automations:
+  add_pr_description:
+    on:
+      - pr_created
+      - commit
+    if:
+      - {{ pr.author | match(list=['github-actions', 'dependabot', '[bot]']) | nope }}
+    run:
+      - action: update-description@v1
+        args:
+          concat_mode: append
+          description: {{ source | AI_DescribePR }}