@orderful/droid 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @orderful/droid
 
+## 0.11.1
+
+### Patch Changes
+
+- [#70](https://github.com/Orderful/droid/pull/70) [`1c0d6e1`](https://github.com/Orderful/droid/commit/1c0d6e134ecf906ae9a8cac4e738620536870530) Thanks [@frytyler](https://github.com/frytyler)! - feat(comments): add two-pass approach for coherent responses when addressing multiple @droid comments
+
 ## 0.11.0
 
 ### Minor Changes

package/dist/tools/comments/TOOL.yaml

@@ -1,6 +1,6 @@
 name: comments
 description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Ideal for code review notes and async collaboration."
-version: 0.2.2
+version: 0.2.3
 status: beta
 
 includes:

package/dist/tools/comments/skills/comments/SKILL.md

@@ -79,13 +79,22 @@ When you find a `@droid` marker:
 
 ### On `/comments check`:
 
+**Use a two-pass approach for coherent responses:**
+
+#### Pass 1: Read & Analyse
 1. **Read config first:** Check `~/.droid/skills/comments/overrides.yaml` for `preserve_comments` setting (default: `true`)
-2. Search for `> @droid` (and any configured `ai_mentions`) in the specified scope
+2. Search for ALL `> @droid` comments (and any configured `ai_mentions`) in the specified scope
 3. If there's a `git diff`, check those files first for relevant context
-4. For each comment, determine intent:
+4. **Read all comments before responding** - understand the full picture
+5. Look for connections between comments (one may inform another)
+6. Note any contradictions or tensions to address
+
+#### Pass 2: Respond & Write
+1. For each comment, determine intent:
    - **Action request** ("do X", "add Y", "fix Z") → Execute the action
    - **Question** ("what do you think", "should we") → Respond with `> @{user_mention}`
-5. **Handle original comment based on `preserve_comments`:**
+2. Ensure responses are coherent across all comments (don't contradict yourself)
+3. **Handle original comment based on `preserve_comments`:**
    - If `preserve_comments: true` → Keep the original `@droid` comment (add response below it)
    - If `preserve_comments: false` → Remove the original comment after addressing
 

package/dist/tools/comments/skills/comments/SKILL.yaml

@@ -1,6 +1,6 @@
 name: comments
 description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration."
-version: 0.2.2
+version: 0.2.3
 status: beta
 dependencies: []
 provides_output: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {

package/src/tools/comments/TOOL.yaml

@@ -1,6 +1,6 @@
 name: comments
 description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Ideal for code review notes and async collaboration."
-version: 0.2.2
+version: 0.2.3
 status: beta
 
 includes:

package/src/tools/comments/skills/comments/SKILL.md

@@ -79,13 +79,22 @@ When you find a `@droid` marker:
 
 ### On `/comments check`:
 
+**Use a two-pass approach for coherent responses:**
+
+#### Pass 1: Read & Analyse
 1. **Read config first:** Check `~/.droid/skills/comments/overrides.yaml` for `preserve_comments` setting (default: `true`)
-2. Search for `> @droid` (and any configured `ai_mentions`) in the specified scope
+2. Search for ALL `> @droid` comments (and any configured `ai_mentions`) in the specified scope
 3. If there's a `git diff`, check those files first for relevant context
-4. For each comment, determine intent:
+4. **Read all comments before responding** - understand the full picture
+5. Look for connections between comments (one may inform another)
+6. Note any contradictions or tensions to address
+
+#### Pass 2: Respond & Write
+1. For each comment, determine intent:
    - **Action request** ("do X", "add Y", "fix Z") → Execute the action
    - **Question** ("what do you think", "should we") → Respond with `> @{user_mention}`
-5. **Handle original comment based on `preserve_comments`:**
+2. Ensure responses are coherent across all comments (don't contradict yourself)
+3. **Handle original comment based on `preserve_comments`:**
    - If `preserve_comments: true` → Keep the original `@droid` comment (add response below it)
    - If `preserve_comments: false` → Remove the original comment after addressing
 

package/src/tools/comments/skills/comments/SKILL.yaml

@@ -1,6 +1,6 @@
 name: comments
 description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration."
-version: 0.2.2
+version: 0.2.3
 status: beta
 dependencies: []
 provides_output: false