.gitea/workflows/ai-chat.yml

@@ -1,17 +1,32 @@
 name: AI Chat (Bartender)
 
+# WORKFLOW ROUTING:
+# This workflow handles FREE-FORM questions/chat (no specific command)
+# Other workflows: ai-issue-triage.yml (@codebot triage), ai-comment-reply.yml (specific commands)
+# This is the FALLBACK for any @codebot mention that isn't a known command
+
 on:
     issue_comment:
         types: [created]
 
 # CUSTOMIZE YOUR BOT NAME:
-# Change '@ai-bot' below to match your config.yml mention_prefix
+# Change '@codebot' in all conditions below to match your config.yml mention_prefix
 # Examples: '@bartender', '@uni', '@joey', '@codebot'
 
 jobs:
     ai-chat:
-    # Only run if comment mentions the bot
-    if: contains(github.event.comment.body, '@codebot') # <-- Change this to your bot name
+        # Only run if comment mentions the bot but NOT a specific command
+        # This prevents duplicate runs with ai-comment-reply.yml and ai-issue-triage.yml
+        if: |
+            contains(github.event.comment.body, '@codebot') &&
+            !contains(github.event.comment.body, '@codebot triage') &&
+            !contains(github.event.comment.body, '@codebot help') &&
+            !contains(github.event.comment.body, '@codebot explain') &&
+            !contains(github.event.comment.body, '@codebot suggest') &&
+            !contains(github.event.comment.body, '@codebot security') &&
+            !contains(github.event.comment.body, '@codebot summarize') &&
+            !contains(github.event.comment.body, '@codebot review-again') &&
+            !contains(github.event.comment.body, '@codebot setup-labels')
         runs-on: ubuntu-latest
         steps:
             - uses: actions/checkout@v4

.gitea/workflows/ai-comment-reply.yml

@@ -1,17 +1,30 @@
 name: AI Comment Reply
 
+# WORKFLOW ROUTING:
+# This workflow handles SPECIFIC commands: help, explain, suggest, security, summarize, review-again, setup-labels
+# Other workflows: ai-issue-triage.yml (@codebot triage), ai-chat.yml (free-form questions)
+
 on:
     issue_comment:
         types: [created]
 
 # CUSTOMIZE YOUR BOT NAME:
-# Change '@ai-bot' below to match your config.yml mention_prefix
+# Change '@codebot' in the 'if' condition below to match your config.yml mention_prefix
 # Examples: '@bartender', '@uni', '@joey', '@codebot'
 
 jobs:
     ai-reply:
         runs-on: ubuntu-latest
-        if: contains(github.event.comment.body, '@codebot') # <-- Change this to your bot name
+        # Only run for specific commands (not free-form chat or triage)
+        # This prevents duplicate runs with ai-chat.yml and ai-issue-triage.yml
+        if: |
+            (contains(github.event.comment.body, '@codebot help') ||
+             contains(github.event.comment.body, '@codebot explain') ||
+             contains(github.event.comment.body, '@codebot suggest') ||
+             contains(github.event.comment.body, '@codebot security') ||
+             contains(github.event.comment.body, '@codebot summarize') ||
+             contains(github.event.comment.body, '@codebot review-again') ||
+             contains(github.event.comment.body, '@codebot setup-labels'))
         steps:
             - uses: actions/checkout@v4
 

.gitea/workflows/ai-issue-triage.yml

@@ -1,5 +1,9 @@
 name: AI Issue Triage
 
+# WORKFLOW ROUTING:
+# This workflow handles ONLY the 'triage' command
+# Other workflows: ai-comment-reply.yml (specific commands), ai-chat.yml (free-form questions)
+
 on:
     issue_comment:
         types: [created]

CLAUDE.md

@@ -186,14 +186,21 @@ Optional:
 
 ## Workflow Architecture
 
-Workflows are located in `.gitea/workflows/`:
+Workflows are located in `.gitea/workflows/` and are **mutually exclusive** to prevent duplicate runs:
 
-- **ai-review.yml** / **enterprise-ai-review.yml** - Triggered on PR open/sync
-- **ai-issue-triage.yml** - Triggered on `@codebot triage` mention in issue comments
-- **ai-comment-reply.yml** - Triggered on issue comments with @bot mentions
-- **ai-chat.yml** - Triggered on issue comments for chat (non-command mentions)
+- **enterprise-ai-review.yml** - Triggered on PR open/sync
+- **ai-issue-triage.yml** - Triggered ONLY on `@codebot triage` in comments
+- **ai-comment-reply.yml** - Triggered on specific commands: `help`, `explain`, `suggest`, `security`, `summarize`, `review-again`, `setup-labels`
+- **ai-chat.yml** - Triggered on `@codebot` mentions that are NOT specific commands (free-form questions)
 - **ai-codebase-review.yml** - Scheduled weekly analysis
 
+**Workflow Routing Logic:**
+1. If comment contains `@codebot triage` → ai-issue-triage.yml only
+2. If comment contains specific command (e.g., `@codebot help`) → ai-comment-reply.yml only
+3. If comment contains `@codebot <question>` (no command) → ai-chat.yml only
+
+This prevents the issue where all three workflows would trigger on every `@codebot` mention, causing massive duplication.
+
 **Note**: Issue triage is now **opt-in** via `@codebot triage` command, not automatic on issue creation.
 
 Key workflow pattern: