@orderful/droid 0.35.0 → 0.35.2

package/.claude-plugin/marketplace.json

@@ -22,7 +22,7 @@
     {
       "name": "droid-brain",
       "description": "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions.",
-      "version": "0.3.5",
+      "version": "0.3.6",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -48,7 +48,7 @@
     {
       "name": "droid-code-review",
       "description": "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring.",
-      "version": "0.2.2",
+      "version": "0.2.3",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -61,7 +61,7 @@
     {
       "name": "droid-codex",
       "description": "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or creating new entries.",
-      "version": "0.2.0",
+      "version": "0.2.1",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -87,7 +87,7 @@
     {
       "name": "droid-plan",
       "description": "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'.",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -126,7 +126,7 @@
     {
       "name": "droid-wrapup",
       "description": "Session wrap-up that captures decisions, learnings, and open items to persistent docs.",
-      "version": "0.1.2",
+      "version": "0.1.3",
       "source": {
         "source": "github",
         "repo": "orderful/droid",

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @orderful/droid
 
+## 0.35.2
+
+### Patch Changes
+
+- [#213](https://github.com/Orderful/droid/pull/213) [`95a67d7`](https://github.com/Orderful/droid/commit/95a67d7f3bc57652113cf89bfb24de84d5d94490) Thanks [@frytyler](https://github.com/frytyler)! - Add explicit Configuration sections to all skills to prevent ambiguous config references. This ensures Claude sees the exact config commands (`droid config --get`) in the main SKILL.md file rather than having to look in references.
+
+  **Updated skills:**
+  - **wrapup** (v0.1.3): Added Configuration section explaining it uses configs from project, brain, and codex tools
+  - **code-review** (v0.2.3): Added Configuration section explaining optional brain integration
+  - **brain** (v0.3.6): Updated brain-obsidian to use explicit `droid config --get` commands instead of referencing override files directly
+
+  This follows the progressive disclosure principle: SKILL.md should have explicit config commands to prevent misinterpretation, with detailed procedures in references.
+
+- [#213](https://github.com/Orderful/droid/pull/213) [`95a67d7`](https://github.com/Orderful/droid/commit/95a67d7f3bc57652113cf89bfb24de84d5d94490) Thanks [@frytyler](https://github.com/frytyler)! - Fix plan skill to use explicit config commands instead of deprecated syntax. The plan skill now clearly specifies `droid config --get tools.brain` and `droid config --get user_mention` instead of the ambiguous "Read config" instruction that was causing Claude to use the deprecated `droid config <tool>` command.
+
+  Also corrected `inbox_dir` to `inbox_folder` throughout plan skill docs to match the actual config schema.
+
+## 0.35.1
+
+### Patch Changes
+
+- [#211](https://github.com/Orderful/droid/pull/211) [`6df8a25`](https://github.com/Orderful/droid/commit/6df8a2511a1680bec65618d0f5e6e684811cd922) Thanks [@frytyler](https://github.com/frytyler)! - Bump codex tool version to force reinstall with fixed subdirectory copying
+
+  Users who installed codex 0.2.0 before the fix would be missing references/review/ subdirectory. Bumping to 0.2.1 ensures they get the complete installation with all reference files.
+
+- [#211](https://github.com/Orderful/droid/pull/211) [`6df8a25`](https://github.com/Orderful/droid/commit/6df8a2511a1680bec65618d0f5e6e684811cd922) Thanks [@frytyler](https://github.com/frytyler)! - Fix skill installation not copying reference and script subdirectories
+
+  The installSkill() function was only copying top-level files from references/ and scripts/ directories, causing subdirectories to be skipped. This blocked the /codex review feature which relies on references/review/workflow.md.
+
+  Added a generic copyDirectoryRecursive() helper that preserves directory structure while maintaining the existing file type filters (.md for references, .ts/.js/.py for scripts). Applied to both references/ and scripts/ copying.
+
 ## 0.35.0
 
 ### Minor Changes

package/dist/bin/droid.js

@@ -1305,6 +1305,22 @@ function updateAllSkills() {
   }
   return result;
 }
+function copyDirectoryRecursive(source, target, fileFilter) {
+  if (!existsSync6(target)) {
+    mkdirSync4(target, { recursive: true });
+  }
+  const entries = readdirSync5(source, { withFileTypes: true });
+  for (const entry of entries) {
+    const sourcePath = join7(source, entry.name);
+    const targetPath = join7(target, entry.name);
+    if (entry.isDirectory()) {
+      copyDirectoryRecursive(sourcePath, targetPath, fileFilter);
+    } else if (entry.isFile() && fileFilter(entry.name)) {
+      const content = readFileSync6(sourcePath, "utf-8");
+      writeFileSync4(targetPath, content);
+    }
+  }
+}
 function installSkill(skillName) {
   const config = loadConfig();
   const skillPath = findSkillPath(skillName);
@@ -1418,34 +1434,20 @@ function installSkill(skillName) {
   const referencesSource = join7(skillDir, "references");
   if (existsSync6(referencesSource)) {
     const targetReferencesDir = join7(targetSkillDir, "references");
-    if (!existsSync6(targetReferencesDir)) {
-      mkdirSync4(targetReferencesDir, { recursive: true });
-    }
-    const referenceFiles = readdirSync5(referencesSource).filter(
+    copyDirectoryRecursive(
+      referencesSource,
+      targetReferencesDir,
       (f) => f.endsWith(".md")
     );
-    for (const file of referenceFiles) {
-      const sourcePath = join7(referencesSource, file);
-      const targetPath = join7(targetReferencesDir, file);
-      const content = readFileSync6(sourcePath, "utf-8");
-      writeFileSync4(targetPath, content);
-    }
   }
   const scriptsSource = join7(skillDir, "scripts");
   if (existsSync6(scriptsSource)) {
     const targetScriptsDir = join7(targetSkillDir, "scripts");
-    if (!existsSync6(targetScriptsDir)) {
-      mkdirSync4(targetScriptsDir, { recursive: true });
-    }
-    const scriptFiles = readdirSync5(scriptsSource).filter(
+    copyDirectoryRecursive(
+      scriptsSource,
+      targetScriptsDir,
       (f) => f.endsWith(".ts") || f.endsWith(".js") || f.endsWith(".py")
     );
-    for (const file of scriptFiles) {
-      const sourcePath = join7(scriptsSource, file);
-      const targetPath = join7(targetScriptsDir, file);
-      const content = readFileSync6(sourcePath, "utf-8");
-      writeFileSync4(targetPath, content);
-    }
   }
   const activePlatforms = getActivePlatforms(config);
   const targetPlatforms = activePlatforms.length > 0 ? activePlatforms : [config.platform];

package/dist/index.js

@@ -1262,6 +1262,22 @@ function updateAllSkills() {
   }
   return result;
 }
+function copyDirectoryRecursive(source, target, fileFilter) {
+  if (!existsSync6(target)) {
+    mkdirSync4(target, { recursive: true });
+  }
+  const entries = readdirSync5(source, { withFileTypes: true });
+  for (const entry of entries) {
+    const sourcePath = join7(source, entry.name);
+    const targetPath = join7(target, entry.name);
+    if (entry.isDirectory()) {
+      copyDirectoryRecursive(sourcePath, targetPath, fileFilter);
+    } else if (entry.isFile() && fileFilter(entry.name)) {
+      const content = readFileSync6(sourcePath, "utf-8");
+      writeFileSync4(targetPath, content);
+    }
+  }
+}
 function installSkill(skillName) {
   const config = loadConfig();
   const skillPath = findSkillPath(skillName);
@@ -1375,34 +1391,20 @@ function installSkill(skillName) {
   const referencesSource = join7(skillDir, "references");
   if (existsSync6(referencesSource)) {
     const targetReferencesDir = join7(targetSkillDir, "references");
-    if (!existsSync6(targetReferencesDir)) {
-      mkdirSync4(targetReferencesDir, { recursive: true });
-    }
-    const referenceFiles = readdirSync5(referencesSource).filter(
+    copyDirectoryRecursive(
+      referencesSource,
+      targetReferencesDir,
       (f) => f.endsWith(".md")
     );
-    for (const file of referenceFiles) {
-      const sourcePath = join7(referencesSource, file);
-      const targetPath = join7(targetReferencesDir, file);
-      const content = readFileSync6(sourcePath, "utf-8");
-      writeFileSync4(targetPath, content);
-    }
   }
   const scriptsSource = join7(skillDir, "scripts");
   if (existsSync6(scriptsSource)) {
     const targetScriptsDir = join7(targetSkillDir, "scripts");
-    if (!existsSync6(targetScriptsDir)) {
-      mkdirSync4(targetScriptsDir, { recursive: true });
-    }
-    const scriptFiles = readdirSync5(scriptsSource).filter(
+    copyDirectoryRecursive(
+      scriptsSource,
+      targetScriptsDir,
       (f) => f.endsWith(".ts") || f.endsWith(".js") || f.endsWith(".py")
     );
-    for (const file of scriptFiles) {
-      const sourcePath = join7(scriptsSource, file);
-      const targetPath = join7(targetScriptsDir, file);
-      const content = readFileSync6(sourcePath, "utf-8");
-      writeFileSync4(targetPath, content);
-    }
   }
   const activePlatforms = getActivePlatforms(config);
   const targetPlatforms = activePlatforms.length > 0 ? activePlatforms : [config.platform];

package/dist/lib/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"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"}

package/dist/tools/brain/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-brain",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions.",
   "author": {
     "name": "Orderful",

package/dist/tools/brain/TOOL.yaml

@@ -1,6 +1,6 @@
 name: brain
 description: "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
-version: 0.3.5
+version: 0.3.6
 status: beta
 
 includes:

package/dist/tools/brain/skills/brain-obsidian/SKILL.md

@@ -15,13 +15,14 @@ Extends the brain skill with Obsidian-specific features. **This skill overrides
 
 ## Configuration
 
-**Required:** Set vault path in `~/.droid/skills/brain/overrides.yaml`:
+**Required:** Run `droid config --get tools.brain` and ensure `brain_dir` is set to your Obsidian vault path.
 
-```yaml
-brain_dir: ~/path/to/your/vault
+If not configured, set it with:
+```bash
+droid config --set tools.brain.brain_dir=~/path/to/your/vault
 ```
 
-**Optional:** Configure folders in `~/.droid/skills/brain-obsidian/overrides.yaml`:
+**Optional:** Configure Obsidian-specific folders with `droid config --get tools.brain-obsidian`:
 
 | Setting            | Default       | Description                     |
 | ------------------ | ------------- | ------------------------------- |

package/dist/tools/code-review/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-code-review",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring.",
   "author": {
     "name": "Orderful",

package/dist/tools/code-review/TOOL.yaml

@@ -1,6 +1,6 @@
 name: code-review
 description: "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring."
-version: 0.2.2
+version: 0.2.3
 status: alpha
 
 includes:

package/dist/tools/code-review/skills/code-review/SKILL.md

@@ -9,6 +9,13 @@ allowed-tools: [Read, Grep, Glob, Bash, Task]
 
 Run comprehensive code reviews using specialized agents, each focused on a specific concern.
 
+## Configuration
+
+Code-review has no configuration of its own. Optional integration with other tools:
+
+- **Brain skill** (optional): If installed, offers to save review results to a `/brain review` doc
+  - Check with: `droid config --get tools.brain` to see if `brain_dir` is configured
+
 ## How It Works
 
 The `/code-review` command orchestrates multiple specialized agents in parallel:

package/dist/tools/codex/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-codex",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or creating new entries.",
   "author": {
     "name": "Orderful",

package/dist/tools/codex/TOOL.yaml

@@ -1,6 +1,6 @@
 name: codex
 description: "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or creating new entries."
-version: 0.2.0
+version: 0.2.1
 status: beta
 
 includes:

package/dist/tools/plan/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-plan",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'.",
   "author": {
     "name": "Orderful",

package/dist/tools/plan/TOOL.yaml

@@ -1,6 +1,6 @@
 name: plan
 description: "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'."
-version: 0.1.0
+version: 0.1.1
 status: alpha
 
 includes:

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

@@ -24,8 +24,8 @@ Task-scoped planning for PRs, tickets, and small features. Lighter than `/tech-d
 ## Configuration
 
 Uses config from dependencies:
-- `droid config --get tools.brain` → `brain_dir`, `inbox_dir`
-- `droid config --get tools.comments` → `user_mention`
+- `droid config --get tools.brain` → `brain_dir`, `inbox_folder`
+- `droid config --get user_mention` → `user_mention` (global config)
 
 ## Commands
 
@@ -39,10 +39,13 @@ Uses config from dependencies:
 
 ## `/plan new {topic}`
 
-1. Read config (`brain_dir`, `inbox_dir`, `user_mention`)
+1. **Read config first:**
+   - Run `droid config --get tools.brain` for `brain_dir` and `inbox_folder`
+   - Run `droid config --get user_mention` for user's mention tag
+   - If `brain_dir` not configured, ask user where to store plans
 2. Determine location:
    - If `/project` active → offer: `{projects_dir}/{project}/plans/`
-   - Otherwise → `{brain_dir}/{inbox_dir}/plans/`
+   - Otherwise → `{brain_dir}/{inbox_folder}/plans/`
 3. Offer context loading (`/project`, `/codex` search)
 4. Ask clarifying questions (goal, scope, constraints)
 5. Generate plan from template (see `references/templates.md`)

package/dist/tools/plan/skills/plan/references/templates.md

@@ -173,4 +173,4 @@ Plans are named `plan-{topic}.md` with kebab-case topic:
 
 ## Location
 
-Plans live in `{brain_dir}/{inbox_dir}/plans/` or `{projects_dir}/{project}/plans/` if project-nested.
+Plans live in `{brain_dir}/{inbox_folder}/plans/` or `{projects_dir}/{project}/plans/` if project-nested.

package/dist/tools/plan/skills/plan/references/workflows.md

@@ -7,8 +7,8 @@ Detailed command flows for the plan skill.
 ### Step 1: Read Configuration
 
 ```bash
-droid config --get tools.brain   # → brain_dir, inbox_dir
-droid config --get tools.comments # → user_mention
+droid config --get tools.brain   # → brain_dir, inbox_folder
+droid config --get user_mention  # → user_mention (global config)
 ```
 
 If brain not configured, ask user for `brain_dir` location.
@@ -21,12 +21,12 @@ Check if `/project` is active (check `{projects_dir}/{project}/PROJECT.md` exist
 ```
 Offer choice via AskUserQuestion:
 - "Project folder" → {projects_dir}/{project}/plans/plan-{topic}.md
-- "Inbox" → {brain_dir}/{inbox_dir}/plans/plan-{topic}.md
+- "Inbox" → {brain_dir}/{inbox_folder}/plans/plan-{topic}.md
 ```
 
 **If no project:**
 ```
-Use: {brain_dir}/{inbox_dir}/plans/plan-{topic}.md
+Use: {brain_dir}/{inbox_folder}/plans/plan-{topic}.md
 ```
 
 ### Step 3: Check for Existing Plan

package/dist/tools/wrapup/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-wrapup",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Session wrap-up that captures decisions, learnings, and open items to persistent docs.",
   "author": {
     "name": "Orderful",

package/dist/tools/wrapup/TOOL.yaml

@@ -1,6 +1,6 @@
 name: wrapup
 description: "Session wrap-up that captures decisions, learnings, and open items to persistent docs."
-version: 0.1.2
+version: 0.1.3
 status: alpha
 
 includes:

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

@@ -8,6 +8,16 @@ allowed-tools: [Read, Edit, Write, Glob, Grep, Bash, Task]
 
 Session wrap-up that captures decisions, learnings, and open items before closing.
 
+## Configuration
+
+Wrapup has no configuration of its own. It reads config from other installed tools:
+
+- **Project skill** (optional): `droid config --get tools.project` → `projects_dir` to update project files
+- **Brain skill** (optional): `droid config --get tools.brain` → `brain_dir` to update brain docs
+- **Codex skill** (optional): `droid config --get tools.codex` → `codex_repo` to suggest codex entries
+
+If these tools aren't configured, wrapup skips those artifacts and focuses on git state and conversation summary.
+
 ## Context Lifeboat Pattern
 
 This skill runs at the END of sessions when context pressure is highest.

package/package.json

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

package/src/lib/skills.ts

@@ -393,6 +393,39 @@ export function updateAllSkills(): {
   return result;
 }
 
+/**
+ * Recursively copy a directory and all its contents
+ * @param source Source directory path
+ * @param target Target directory path
+ * @param fileFilter Function that returns true if the file should be copied
+ */
+function copyDirectoryRecursive(
+  source: string,
+  target: string,
+  fileFilter: (filename: string) => boolean,
+): void {
+  if (!existsSync(target)) {
+    mkdirSync(target, { recursive: true });
+  }
+
+  const entries = readdirSync(source, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const sourcePath = join(source, entry.name);
+    const targetPath = join(target, entry.name);
+
+    if (entry.isDirectory()) {
+      // Recursively copy subdirectory
+      copyDirectoryRecursive(sourcePath, targetPath, fileFilter);
+    } else if (entry.isFile() && fileFilter(entry.name)) {
+      // Copy file if it passes the filter
+      const content = readFileSync(sourcePath, 'utf-8');
+      writeFileSync(targetPath, content);
+    }
+    // Ignore files that don't pass the filter
+  }
+}
+
 /**
  * Install a skill
  */
@@ -553,36 +586,20 @@ export function installSkill(skillName: string): {
   const referencesSource = join(skillDir, 'references');
   if (existsSync(referencesSource)) {
     const targetReferencesDir = join(targetSkillDir, 'references');
-    if (!existsSync(targetReferencesDir)) {
-      mkdirSync(targetReferencesDir, { recursive: true });
-    }
-    const referenceFiles = readdirSync(referencesSource).filter((f) =>
+    copyDirectoryRecursive(referencesSource, targetReferencesDir, (f) =>
       f.endsWith('.md'),
     );
-    for (const file of referenceFiles) {
-      const sourcePath = join(referencesSource, file);
-      const targetPath = join(targetReferencesDir, file);
-      const content = readFileSync(sourcePath, 'utf-8');
-      writeFileSync(targetPath, content);
-    }
   }
 
   // Copy scripts if present (deterministic CLI scripts for the skill)
   const scriptsSource = join(skillDir, 'scripts');
   if (existsSync(scriptsSource)) {
     const targetScriptsDir = join(targetSkillDir, 'scripts');
-    if (!existsSync(targetScriptsDir)) {
-      mkdirSync(targetScriptsDir, { recursive: true });
-    }
-    const scriptFiles = readdirSync(scriptsSource).filter(
+    copyDirectoryRecursive(
+      scriptsSource,
+      targetScriptsDir,
       (f) => f.endsWith('.ts') || f.endsWith('.js') || f.endsWith('.py'),
     );
-    for (const file of scriptFiles) {
-      const sourcePath = join(scriptsSource, file);
-      const targetPath = join(targetScriptsDir, file);
-      const content = readFileSync(sourcePath, 'utf-8');
-      writeFileSync(targetPath, content);
-    }
   }
 
   // Get active platforms for multi-platform install

package/src/tools/brain/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-brain",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions.",
   "author": {
     "name": "Orderful",

package/src/tools/brain/TOOL.yaml

@@ -1,6 +1,6 @@
 name: brain
 description: "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
-version: 0.3.5
+version: 0.3.6
 status: beta
 
 includes:

package/src/tools/brain/skills/brain-obsidian/SKILL.md

@@ -15,13 +15,14 @@ Extends the brain skill with Obsidian-specific features. **This skill overrides
 
 ## Configuration
 
-**Required:** Set vault path in `~/.droid/skills/brain/overrides.yaml`:
+**Required:** Run `droid config --get tools.brain` and ensure `brain_dir` is set to your Obsidian vault path.
 
-```yaml
-brain_dir: ~/path/to/your/vault
+If not configured, set it with:
+```bash
+droid config --set tools.brain.brain_dir=~/path/to/your/vault
 ```
 
-**Optional:** Configure folders in `~/.droid/skills/brain-obsidian/overrides.yaml`:
+**Optional:** Configure Obsidian-specific folders with `droid config --get tools.brain-obsidian`:
 
 | Setting            | Default       | Description                     |
 | ------------------ | ------------- | ------------------------------- |

package/src/tools/code-review/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-code-review",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring.",
   "author": {
     "name": "Orderful",

package/src/tools/code-review/TOOL.yaml

@@ -1,6 +1,6 @@
 name: code-review
 description: "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring."
-version: 0.2.2
+version: 0.2.3
 status: alpha
 
 includes:

package/src/tools/code-review/skills/code-review/SKILL.md

@@ -9,6 +9,13 @@ allowed-tools: [Read, Grep, Glob, Bash, Task]
 
 Run comprehensive code reviews using specialized agents, each focused on a specific concern.
 
+## Configuration
+
+Code-review has no configuration of its own. Optional integration with other tools:
+
+- **Brain skill** (optional): If installed, offers to save review results to a `/brain review` doc
+  - Check with: `droid config --get tools.brain` to see if `brain_dir` is configured
+
 ## How It Works
 
 The `/code-review` command orchestrates multiple specialized agents in parallel:

package/src/tools/codex/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-codex",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or creating new entries.",
   "author": {
     "name": "Orderful",

package/src/tools/codex/TOOL.yaml

@@ -1,6 +1,6 @@
 name: codex
 description: "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or creating new entries."
-version: 0.2.0
+version: 0.2.1
 status: beta
 
 includes:

package/src/tools/plan/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-plan",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'.",
   "author": {
     "name": "Orderful",

package/src/tools/plan/TOOL.yaml

@@ -1,6 +1,6 @@
 name: plan
 description: "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'."
-version: 0.1.0
+version: 0.1.1
 status: alpha
 
 includes:

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

@@ -24,8 +24,8 @@ Task-scoped planning for PRs, tickets, and small features. Lighter than `/tech-d
 ## Configuration
 
 Uses config from dependencies:
-- `droid config --get tools.brain` → `brain_dir`, `inbox_dir`
-- `droid config --get tools.comments` → `user_mention`
+- `droid config --get tools.brain` → `brain_dir`, `inbox_folder`
+- `droid config --get user_mention` → `user_mention` (global config)
 
 ## Commands
 
@@ -39,10 +39,13 @@ Uses config from dependencies:
 
 ## `/plan new {topic}`
 
-1. Read config (`brain_dir`, `inbox_dir`, `user_mention`)
+1. **Read config first:**
+   - Run `droid config --get tools.brain` for `brain_dir` and `inbox_folder`
+   - Run `droid config --get user_mention` for user's mention tag
+   - If `brain_dir` not configured, ask user where to store plans
 2. Determine location:
    - If `/project` active → offer: `{projects_dir}/{project}/plans/`
-   - Otherwise → `{brain_dir}/{inbox_dir}/plans/`
+   - Otherwise → `{brain_dir}/{inbox_folder}/plans/`
 3. Offer context loading (`/project`, `/codex` search)
 4. Ask clarifying questions (goal, scope, constraints)
 5. Generate plan from template (see `references/templates.md`)

package/src/tools/plan/skills/plan/references/templates.md

@@ -173,4 +173,4 @@ Plans are named `plan-{topic}.md` with kebab-case topic:
 
 ## Location
 
-Plans live in `{brain_dir}/{inbox_dir}/plans/` or `{projects_dir}/{project}/plans/` if project-nested.
+Plans live in `{brain_dir}/{inbox_folder}/plans/` or `{projects_dir}/{project}/plans/` if project-nested.

package/src/tools/plan/skills/plan/references/workflows.md

@@ -7,8 +7,8 @@ Detailed command flows for the plan skill.
 ### Step 1: Read Configuration
 
 ```bash
-droid config --get tools.brain   # → brain_dir, inbox_dir
-droid config --get tools.comments # → user_mention
+droid config --get tools.brain   # → brain_dir, inbox_folder
+droid config --get user_mention  # → user_mention (global config)
 ```
 
 If brain not configured, ask user for `brain_dir` location.
@@ -21,12 +21,12 @@ Check if `/project` is active (check `{projects_dir}/{project}/PROJECT.md` exist
 ```
 Offer choice via AskUserQuestion:
 - "Project folder" → {projects_dir}/{project}/plans/plan-{topic}.md
-- "Inbox" → {brain_dir}/{inbox_dir}/plans/plan-{topic}.md
+- "Inbox" → {brain_dir}/{inbox_folder}/plans/plan-{topic}.md
 ```
 
 **If no project:**
 ```
-Use: {brain_dir}/{inbox_dir}/plans/plan-{topic}.md
+Use: {brain_dir}/{inbox_folder}/plans/plan-{topic}.md
 ```
 
 ### Step 3: Check for Existing Plan

package/src/tools/wrapup/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-wrapup",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Session wrap-up that captures decisions, learnings, and open items to persistent docs.",
   "author": {
     "name": "Orderful",

package/src/tools/wrapup/TOOL.yaml

@@ -1,6 +1,6 @@
 name: wrapup
 description: "Session wrap-up that captures decisions, learnings, and open items to persistent docs."
-version: 0.1.2
+version: 0.1.3
 status: alpha
 
 includes:

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

@@ -8,6 +8,16 @@ allowed-tools: [Read, Edit, Write, Glob, Grep, Bash, Task]
 
 Session wrap-up that captures decisions, learnings, and open items before closing.
 
+## Configuration
+
+Wrapup has no configuration of its own. It reads config from other installed tools:
+
+- **Project skill** (optional): `droid config --get tools.project` → `projects_dir` to update project files
+- **Brain skill** (optional): `droid config --get tools.brain` → `brain_dir` to update brain docs
+- **Codex skill** (optional): `droid config --get tools.codex` → `codex_repo` to suggest codex entries
+
+If these tools aren't configured, wrapup skips those artifacts and focuses on git state and conversation summary.
+
 ## Context Lifeboat Pattern
 
 This skill runs at the END of sessions when context pressure is highest.