Improve AI assistance tracking in documentation

Author: vim-zz

docs/automations/integrations/copilot/flag-copilot-pr/README.md

@@ -9,18 +9,22 @@ starter_kits: [genai]
 Automatically apply labels to PRs that are assisted by GitHub Copilot. You can apply labels based on a known list of Copilot users, PR tags, or by prompting the PR author to indicate if they used Copilot.
 
 === "Label by AI Rules"
-    Automatically apply labels to PRs based on Copilot AI rules.
+    Automatically apply labels to PRs based on Copilot AI rules, providing a data-driven approach to track developer adoption of AI tools without requiring manual input from developers.
+
+    This solution automatically tracks AI tool usage without requiring developers to fill out surveys or take manual actions. Each AI-assisted edit is logged with unique identifiers in structured JSON format, setting the foundation for analytics across different AI tools while maintaining a consistent data model.
 
     !!! info "Configuration Description"
         Conditions:
 
         * A PR is created
         * Copilot AI was used in this PR
         * Copilot rule file was added to the repo
+        * Changes to `.cm/ai.log` file are detected (this file contains entries for each AI-assisted action)
 
         Automation Actions:
 
         * PR is labeled with `ai-assisted`
+        * Structured data about AI usage is logged for future analytics
 
     !!! example "`.github/copilot-instructions.md`"
         ```yaml+jinja
@@ -42,6 +46,9 @@ Automatically apply labels to PRs that are assisted by GitHub Copilot. You can a
         </span>
         </div>
 
+    !!! tip
+        Add `.cm/ai.log linguist-generated=true` to your `.gitattributes` file to ensure that Copilot-generated files are not included in your repository.
+
 === "Label by Survey"
     Prompt PR authors to indicate if they used Copilot for the PR and automatically label the PR if they did. This requires two separate automation files to handle posting the prompt and labeling accordingly.
 

docs/automations/integrations/cursor/flag-cursor-pr/README.md

@@ -9,18 +9,22 @@ category: [quality, genai, cursor, quickstart]
 Automatically apply labels to Pull Requests that are assisted by Cursor AI. This automation helps track the impact and usage of Cursor's AI capabilities across your development workflow.
 
 === "Label by AI Rules"
-    Automatically apply labels to PRs based on Cursor AI rules.
+    Automatically apply labels to PRs based on Cursor AI rules, providing a data-driven approach to track developer adoption of AI tools without requiring manual input from developers.
+
+    This solution automatically tracks AI tool usage without requiring developers to fill out surveys or take manual actions. Each AI-assisted edit is logged with unique identifiers in structured JSON format, setting the foundation for analytics across different AI tools while maintaining a consistent data model.
 
     !!! info "Configuration Description"
         Conditions:
 
         * A PR is created
         * Cursor AI was used in this PR
         * Cursor rule file was added to the repo
+        * Changes to `.cm/ai.log` file are detected (this file contains entries for each AI-assisted action)
 
         Automation Actions:
 
         * PR is labeled with `ai-assisted`
+        * Structured data about AI usage is logged for future analytics
 
     !!! example "`.cursor/rules/cursor-ai-logging.mdc`"
         ```yaml+jinja
@@ -42,6 +46,10 @@ Automatically apply labels to Pull Requests that are assisted by Cursor AI. This
         </span>
         </div>
 
+    !!! tip
+        Add `.cm/ai.log linguist-generated=true` to your `.gitattributes` file to ensure that AI-generated files are marked as generated content.
+
+
 === "Label by Survey"
     Prompt PR authors to indicate if they used Cursor for the PR and automatically label the PR if they did. This requires two separate automation files to handle posting the prompt and labeling accordingly.
 

docs/downloads/automation-library/integrations/copilot/label_copilot_by_rule.cm

@@ -9,4 +9,4 @@ automations:
       - action: add-labels@v1
         args:
           labels:
-            - ai-tool-usage
+            - ai-assisted

docs/downloads/automation-library/integrations/cursor/label_cursor_by_rule.cm

@@ -9,4 +9,4 @@ automations:
       - action: add-labels@v1
         args:
           labels:
-            - ai-tool-usage
+            - ai-assisted