@orderful/droid 0.44.1 → 0.45.0

package/.github/workflows/claude-issue-agent.yml

@@ -0,0 +1,238 @@
+name: Claude Issue Agent
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  implement:
+    if: github.event.label.name == 'claude'
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+      id-token: write
+      actions: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Checkout codex for project context
+        continue-on-error: true
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.CODEX_ACCESS_TOKEN }}
+          script: |
+            const fs = require('fs');
+            const path = require('path');
+
+            const files = [
+              'projects/droid/CONTEXT.md',
+              'projects/droid/DECISIONS.md',
+              'projects/droid/artifacts/concept-skills.md',
+              'projects/droid/artifacts/concept-commands.md',
+              'projects/droid/artifacts/concept-agents.md'
+            ];
+
+            for (const file of files) {
+              try {
+                const { data } = await github.rest.repos.getContent({
+                  owner: 'Orderful',
+                  repo: 'orderful-codex',
+                  path: file,
+                });
+                const content = Buffer.from(data.content, 'base64').toString('utf-8');
+                const dest = path.join('.codex-context', file);
+                fs.mkdirSync(path.dirname(dest), { recursive: true });
+                fs.writeFileSync(dest, content);
+                console.log(`Fetched ${file}`);
+              } catch (e) {
+                console.log(`Skipped ${file}: ${e.message}`);
+              }
+            }
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+
+      # ── Step 1: Plan (read-only exploration → structured JSON output) ──
+
+      - name: Generate implementation plan
+        id: plan
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            You are an autonomous coding agent. Read the GitHub issue below and
+            create a detailed implementation plan. Do NOT write any code — only
+            explore the codebase and plan.
+
+            ## Issue Context
+            REPO: ${{ github.repository }}
+            ISSUE NUMBER: ${{ github.event.issue.number }}
+            TITLE: ${{ github.event.issue.title }}
+            BODY: ${{ github.event.issue.body }}
+            LABELS: ${{ join(github.event.issue.labels.*.name, ', ') }}
+
+            ## Project Knowledge
+            If `.codex-context/projects/droid/` exists, read these files first:
+            - `.codex-context/projects/droid/CONTEXT.md` — Architecture, tools, patterns
+            - `.codex-context/projects/droid/DECISIONS.md` — Historical decisions with rationale
+
+            Also read CLAUDE.md and AGENTS.md in the repo root for conventions.
+
+            ## Your Task
+            1. Read the issue carefully. Understand the goal and constraints.
+            2. Read project context files (codex, CLAUDE.md, AGENTS.md).
+            3. Explore the codebase — find relevant files, understand existing patterns.
+            4. Produce a structured plan as JSON with these fields:
+               - summary: What the issue asks for and why
+               - approach: Your proposed high-level strategy and key design decisions
+               - files_to_change: Array of strings, each describing a file path and what to change
+               - testing_strategy: How to verify the implementation
+               - risks: Any risks, open questions, or assumptions (empty string if none)
+
+          claude_args: >-
+            --max-turns 30
+            --model claude-sonnet-4-6
+            --allowedTools "Read,Glob,Grep,Bash(ls *),Bash(cat *),Bash(git *),Task"
+            --json-schema '{"type":"object","properties":{"summary":{"type":"string"},"approach":{"type":"string"},"files_to_change":{"type":"array","items":{"type":"string"}},"testing_strategy":{"type":"string"},"risks":{"type":"string"}},"required":["summary","approach","files_to_change","testing_strategy","risks"]}'
+
+      # ── Step 2: Post plan as comment (guaranteed — no agent discretion) ──
+
+      - name: Post plan to issue
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PLAN_JSON: ${{ steps.plan.outputs.structured_output }}
+        run: |
+          {
+            echo "## Implementation Plan"
+            echo ""
+            echo "### Summary"
+            echo "$PLAN_JSON" | jq -r '.summary'
+            echo ""
+            echo "### Approach"
+            echo "$PLAN_JSON" | jq -r '.approach'
+            echo ""
+            echo "### Files to Change"
+            echo "$PLAN_JSON" | jq -r '.files_to_change[]' | sed 's/^/- /'
+            echo ""
+            echo "### Testing Strategy"
+            echo "$PLAN_JSON" | jq -r '.testing_strategy'
+            echo ""
+            echo "### Risks / Open Questions"
+            echo "$PLAN_JSON" | jq -r 'if .risks == "" then "None identified" else .risks end'
+            echo ""
+            echo "---"
+            echo "*Proceeding with implementation. PR will be opened when complete.*"
+          } > /tmp/plan-comment.md
+
+          gh issue comment ${{ github.event.issue.number }} --body-file /tmp/plan-comment.md
+
+      # ── Step 3: Implement (follows the plan, makes changes) ──
+
+      # Re-checkout to refresh git credentials (plan step's action revokes them on cleanup)
+      - name: Refresh git credentials
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Implement solution
+        id: implement
+        uses: anthropics/claude-code-action@v1
+        with:
+          github_token: ${{ github.token }}
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          track_progress: true
+
+          prompt: |
+            You are an autonomous coding agent. Implement the plan below for
+            issue #${{ github.event.issue.number }}.
+
+            ## Issue
+            TITLE: ${{ github.event.issue.title }}
+            BODY: ${{ github.event.issue.body }}
+
+            ## Implementation Plan (follow this)
+            ${{ steps.plan.outputs.structured_output }}
+
+            ## Instructions
+            1. Implement the solution following the plan above.
+            2. Follow all conventions in CLAUDE.md and AGENTS.md:
+               - TypeScript strict mode, single quotes
+               - Canadian spelling (behaviour, colour, honour)
+               - Use "allow list/deny list" not "whitelist/blacklist"
+            3. Keep changes focused — implement what the plan says, nothing more.
+            4. Add a changeset if this changes the droid package:
+               ```bash
+               mkdir -p .changeset && cat > .changeset/<descriptive-name>.md << 'CHANGESET'
+               ---
+               "@orderful/droid": patch
+               ---
+
+               Brief description of the change
+               CHANGESET
+               ```
+            5. Run the linter: `bun run lint`
+            6. Run tests: `bun run test`
+            7. Fix any issues found. If tests/lint fail after 2 attempts, note failures and proceed.
+            8. Run `bun run build` if you changed any TOOL.yaml or plugin.json files.
+            9. Stage and commit changes with a conventional commit message.
+            10. Open a PR with `gh pr create` targeting main, with a clear title and description.
+                Add `--reviewer frytyler` and include `Closes #${{ github.event.issue.number }}` in the body.
+
+          claude_args: >-
+            --max-turns 100
+            --model claude-sonnet-4-6
+            --allowedTools "Bash(bun *),Bash(gh *),Bash(git *),Bash(ls *),Bash(mkdir *),Bash(cat *),Read,Write,Edit,Glob,Grep,Task"
+
+      # ── Step 4: Ensure PR exists (safety net if agent didn't create one) ──
+
+      - name: Ensure PR exists
+        continue-on-error: true
+        if: steps.implement.outputs.branch_name
+        env:
+          GH_TOKEN: ${{ steps.implement.outputs.github_token || github.token }}
+          PLAN_JSON: ${{ steps.plan.outputs.structured_output }}
+        run: |
+          BRANCH="${{ steps.implement.outputs.branch_name }}"
+
+          # Check if a PR already exists for this branch (agent may have created one)
+          EXISTING_PR=$(gh pr list --head "$BRANCH" --json number --jq '.[0].number // empty')
+          if [ -n "$EXISTING_PR" ]; then
+            echo "PR #$EXISTING_PR already exists for branch $BRANCH — skipping creation"
+            exit 0
+          fi
+
+          SUMMARY=$(echo "$PLAN_JSON" | jq -r '.summary')
+
+          gh pr create \
+            --head "$BRANCH" \
+            --title "$(git log -1 --format='%s' "origin/$BRANCH")" \
+            --body "$(cat <<EOF
+          ### Summary :sparkles:
+
+          ${SUMMARY}
+
+          See the **Implementation Plan** comment on #${{ github.event.issue.number }} for the full approach.
+
+          ### Changes
+
+          $(git log "origin/main..origin/$BRANCH" --format='- %s')
+
+          ## Ticket
+
+          Closes #${{ github.event.issue.number }}
+
+          ---
+          🤖 Autonomously implemented by [Claude Code](https://claude.com/claude-code)
+          EOF
+          )" \
+            --reviewer frytyler

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @orderful/droid
 
+## 0.45.0
+
+### Minor Changes
+
+- [#279](https://github.com/Orderful/droid/pull/279) [`c602d09`](https://github.com/Orderful/droid/commit/c602d09fc2ac395a4a4c7a1c92056c68485c28fa) Thanks [@github-actions](https://github.com/apps/github-actions)! - Add `coaching_intensity` config option to coach skill (`light` / `moderate` / `deep`). Shifts the default proposing/questioning ratio from 40/60 to 50/50 at `moderate` intensity and adds per-turn output discipline (3-5 focused points, prefer one sharp question over several surface-level ones). Users wanting the previous Socratic-heavy behaviour can set `coaching_intensity: deep`.
+
+- [#271](https://github.com/Orderful/droid/pull/271) [`e3f8a7e`](https://github.com/Orderful/droid/commit/e3f8a7e4a40cd08ae407923a6329a6e08be72e22) Thanks [@github-actions](https://github.com/apps/github-actions)! - Add `--` escape syntax support to all skills for custom instructions
+
+  Any skill command now accepts a ` -- {instruction}` suffix. Split on the first `--` (space-dash-dash-space): left is the command and args, right is additional context or instruction applied throughout the execution.
+
+  Example: `/brain research caching -- focus on Redis patterns`
+
+- [#281](https://github.com/Orderful/droid/pull/281) [`5cba361`](https://github.com/Orderful/droid/commit/5cba361bbe63a1d41c366673da08daa663bdf786) Thanks [@github-actions](https://github.com/apps/github-actions)! - wrapup: suggest updates to existing codex entries, add persist_recaps config to save session recaps to brain vault
+
+### Patch Changes
+
+- [#267](https://github.com/Orderful/droid/pull/267) [`488a37f`](https://github.com/Orderful/droid/commit/488a37f28cfc520e5a9af56b4b66334f22ff09c7) Thanks [@frytyler](https://github.com/frytyler)! - Auto-detect Granola MCP server status from Claude Code settings instead of relying solely on a manually-set config flag
+
+- [#286](https://github.com/Orderful/droid/pull/286) [`6d5d9ca`](https://github.com/Orderful/droid/commit/6d5d9cacfe87d18b85e8cefd29a4de9324be201e) Thanks [@github-actions](https://github.com/apps/github-actions)! - project: skip CHANGELOG.md on initial load to preserve context window savings
+
+- [#284](https://github.com/Orderful/droid/pull/284) [`992b8ef`](https://github.com/Orderful/droid/commit/992b8efdca3be95b46e50b5ec0cafefcd4683c33) Thanks [@github-actions](https://github.com/apps/github-actions)! - Release tool now detects high-risk PR labels and surfaces them in PR body, Slack notification, status output, and merge confirmation.
+
 ## 0.44.1
 
 ### Patch Changes

package/dist/bin/droid.js

@@ -2532,9 +2532,9 @@ async function updateCommand(tool, options) {
 // src/commands/tui.tsx
 import { render, Box as Box16, Text as Text17, useInput as useInput9, useApp as useApp2 } from "ink";
 import { useState as useState10, useEffect } from "react";
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 import { spawnSync as spawnSync4 } from "child_process";
-import { join as join11, dirname as dirname7 } from "path";
+import { join as join12, dirname as dirname7 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 
 // src/commands/tui/constants.ts
@@ -4511,6 +4511,28 @@ function checkGhAuth() {
   }
 }
 
+// src/integrations/granola/index.ts
+import { join as join11 } from "path";
+import { homedir as homedir6 } from "os";
+import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
+function checkGranolaAuth() {
+  try {
+    const settingsPath = join11(homedir6(), ".claude", "settings.json");
+    if (!existsSync10(settingsPath)) {
+      return false;
+    }
+    const raw = readFileSync9(settingsPath, "utf-8");
+    const settings = JSON.parse(raw);
+    const mcpServers = settings["mcpServers"];
+    if (!mcpServers || typeof mcpServers !== "object") {
+      return false;
+    }
+    return Object.keys(mcpServers).some((key) => key.toLowerCase().includes("granola"));
+  } catch {
+    return false;
+  }
+}
+
 // src/commands/tui.tsx
 import { Fragment as Fragment2, jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
 var exitMessage = null;
@@ -4522,10 +4544,10 @@ var INTEGRATION_GUIDE_TITLES = {
   granola: "Granola Integration Setup"
 };
 var __tui_dirname = dirname7(fileURLToPath5(import.meta.url));
-var INTEGRATIONS_DIR = join11(__tui_dirname, "../integrations");
+var INTEGRATIONS_DIR = join12(__tui_dirname, "../integrations");
 function loadIntegrationReference(integration, filename) {
   try {
-    return readFileSync9(join11(INTEGRATIONS_DIR, integration, "references", filename), "utf-8");
+    return readFileSync10(join12(INTEGRATIONS_DIR, integration, "references", filename), "utf-8");
   } catch {
     return null;
   }
@@ -4630,6 +4652,14 @@ function App() {
       }
     }
   }, []);
+  useEffect(() => {
+    if (!getConfigValue("integrations.granola.configured")) {
+      const isConfigured = checkGranolaAuth();
+      if (isConfigured) {
+        setConfigValue("integrations.granola.configured", true);
+      }
+    }
+  }, []);
   useInput9(
     (input, key) => {
       if (message) setMessage(null);
@@ -5071,8 +5101,8 @@ async function tuiCommand() {
 // src/commands/exec.ts
 import chalk9 from "chalk";
 import { spawn } from "child_process";
-import { existsSync as existsSync10 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync11 } from "fs";
+import { join as join13 } from "path";
 function getRuntime(toolPath) {
   if (toolPath.endsWith(".ts") || toolPath.endsWith(".js")) {
     return { cmd: "bun", args: ["run", toolPath] };
@@ -5085,21 +5115,21 @@ function getRuntime(toolPath) {
 async function execCommand(tool, script, args) {
   const config = loadConfig();
   const skillsPath = getSkillsPath(config.platform);
-  const toolDir = join12(skillsPath, tool);
-  if (!existsSync10(toolDir)) {
+  const toolDir = join13(skillsPath, tool);
+  if (!existsSync11(toolDir)) {
     console.error(chalk9.red(`Tool '${tool}' not found at ${toolDir}`));
     process.exit(1);
   }
-  const scriptsDir = join12(toolDir, "scripts");
-  if (!existsSync10(scriptsDir)) {
+  const scriptsDir = join13(toolDir, "scripts");
+  if (!existsSync11(scriptsDir)) {
     console.error(chalk9.red(`No scripts directory in tool '${tool}'`));
     process.exit(1);
   }
   const extensions = [".ts", ".js", ".py"];
   let scriptPath = null;
   for (const ext of extensions) {
-    const candidate = join12(scriptsDir, script + ext);
-    if (existsSync10(candidate)) {
+    const candidate = join13(scriptsDir, script + ext);
+    if (existsSync11(candidate)) {
       scriptPath = candidate;
       break;
     }
@@ -5292,8 +5322,8 @@ import inquirer5 from "inquirer";
 import chalk11 from "chalk";
 import { execSync as execSync6 } from "child_process";
 import { createServer } from "https";
-import { readFileSync as readFileSync10, mkdirSync as mkdirSync7, appendFileSync as appendFileSync2, writeFileSync as writeFileSync6 } from "fs";
-import { join as join13 } from "path";
+import { readFileSync as readFileSync11, mkdirSync as mkdirSync7, appendFileSync as appendFileSync2, writeFileSync as writeFileSync6 } from "fs";
+import { join as join14 } from "path";
 
 // src/integrations/slack/index.ts
 import { WebClient } from "@slack/web-api";
@@ -5415,13 +5445,13 @@ var SUCCESS_HTML = `<!DOCTYPE html>
   </div>
 </body>
 </html>`;
-var CERT_DIR = join13(process.env.HOME || "", ".droid", "certs");
-var CERT_KEY_PATH = join13(CERT_DIR, "localhost-key.pem");
-var CERT_PATH = join13(CERT_DIR, "localhost.pem");
+var CERT_DIR = join14(process.env.HOME || "", ".droid", "certs");
+var CERT_KEY_PATH = join14(CERT_DIR, "localhost-key.pem");
+var CERT_PATH = join14(CERT_DIR, "localhost.pem");
 function getOrCreateCert() {
   try {
-    const key = readFileSync10(CERT_KEY_PATH, "utf-8");
-    const cert = readFileSync10(CERT_PATH, "utf-8");
+    const key = readFileSync11(CERT_KEY_PATH, "utf-8");
+    const cert = readFileSync11(CERT_PATH, "utf-8");
     if (key && cert) return { key, cert };
   } catch {
   }
@@ -5431,8 +5461,8 @@ function getOrCreateCert() {
     { stdio: "ignore" }
   );
   return {
-    key: readFileSync10(CERT_KEY_PATH, "utf-8"),
-    cert: readFileSync10(CERT_PATH, "utf-8")
+    key: readFileSync11(CERT_KEY_PATH, "utf-8"),
+    cert: readFileSync11(CERT_PATH, "utf-8")
   };
 }
 function trustCertInKeychain() {
@@ -5494,7 +5524,7 @@ function writeTokenToShellRc(key, value) {
   const exportLine = buildExportLine(key, value, isFish);
   const fullPath = expandHome(rcPath);
   try {
-    const existing = readFileSync10(fullPath, "utf-8");
+    const existing = readFileSync11(fullPath, "utf-8");
     if (existing.includes(`${key}=`) || existing.includes(`${key} "`)) {
       const lines = existing.split("\n");
       const pattern = isFish ? new RegExp(`^set\\s+-gx\\s+${key}\\s+`) : new RegExp(`^export\\s+${key}=`);
@@ -5705,7 +5735,7 @@ async function integrationsStatusCommand() {
 async function slackPostCommand(options) {
   let input;
   try {
-    input = readFileSync10(0, "utf-8").trim();
+    input = readFileSync11(0, "utf-8").trim();
   } catch {
     console.log(JSON.stringify({ ok: false, error: "Failed to read from stdin. Pipe JSON payload via stdin." }));
     process.exit(1);

package/dist/commands/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/commands/tui.tsx"],"names":[],"mappings":"AAktBA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBhD"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/commands/tui.tsx"],"names":[],"mappings":"AA6tBA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBhD"}

package/dist/integrations/granola/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Check if a Granola MCP server is registered in Claude Code's settings.
+ * Returns true if any mcpServers entry key contains "granola" (case-insensitive).
+ */
+export declare function checkGranolaAuth(): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/granola/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/granola/index.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAmB1C"}

package/dist/integrations/granola/index.ts

@@ -0,0 +1,28 @@
+import { join } from 'path';
+import { homedir } from 'os';
+import { existsSync, readFileSync } from 'fs';
+
+/**
+ * Check if a Granola MCP server is registered in Claude Code's settings.
+ * Returns true if any mcpServers entry key contains "granola" (case-insensitive).
+ */
+export function checkGranolaAuth(): boolean {
+  try {
+    const settingsPath = join(homedir(), '.claude', 'settings.json');
+    if (!existsSync(settingsPath)) {
+      return false;
+    }
+
+    const raw = readFileSync(settingsPath, 'utf-8');
+    const settings = JSON.parse(raw) as Record<string, unknown>;
+
+    const mcpServers = settings['mcpServers'];
+    if (!mcpServers || typeof mcpServers !== 'object') {
+      return false;
+    }
+
+    return Object.keys(mcpServers).some((key) => key.toLowerCase().includes('granola'));
+  } catch {
+    return false;
+  }
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "droid-brain",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "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.4.0
+version: 0.4.1
 status: beta
 
 includes:

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

@@ -47,6 +47,12 @@ droid config --set tools.brain.brain_dir="{user's choice}"
 
 **Overrides:** This skill supports user-defined overrides. See `/droid` skill § Skill Overrides for how to create, register, and use overrides.
 
+## Custom Instructions
+
+Any command accepts a ` -- {instruction}` suffix. Split on the **first** ` -- ` (space-dash-dash-space): left is the command and its args, right is additional context or instruction to carry through the entire execution.
+
+Example: `/brain research caching -- focus on Redis patterns`
+
 ## Commands
 
 **Reserved keywords:** `search`, `add`, `check`, `cleanup`, `done`

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

@@ -1,6 +1,6 @@
 {
   "name": "droid-coach",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "description": "Learning-mode AI assistance - AI as coach, not crutch. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions.",
   "author": {
     "name": "Orderful",

package/dist/tools/coach/TOOL.yaml

@@ -1,6 +1,6 @@
 name: coach
 description: "Learning-mode AI assistance - AI as coach, not crutch. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions."
-version: 0.2.4
+version: 0.3.0
 status: beta
 
 includes:
@@ -20,3 +20,7 @@ config_schema:
     type: string
     description: "How detailed scaffold hints should be: minimal (signatures only), medium (hints), detailed (pseudocode)"
     default: "medium"
+  coaching_intensity:
+    type: string
+    description: "How Socratic coaching interactions are: light (1-2 targeted questions, concise), moderate (2-3 questions, brief context), deep (thorough exploration, current behaviour)"
+    default: "moderate"

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

@@ -49,10 +49,11 @@ plan → AI scaffolds → human implements → AI coaches → iterate → ship
 
 ## Configuration
 
-| Setting              | Default  | Description                                             |
-| -------------------- | -------- | ------------------------------------------------------- |
-| `scaffold_verbosity` | `medium` | How detailed hints are: `minimal`, `medium`, `detailed` |
-| `override`           | (none)   | User-defined behaviour overrides                        |
+| Setting               | Default    | Description                                                                                       |
+| --------------------- | ---------- | ------------------------------------------------------------------------------------------------- |
+| `scaffold_verbosity`  | `medium`   | How detailed hints are: `minimal`, `medium`, `detailed`                                           |
+| `coaching_intensity`  | `moderate` | How Socratic interactions are: `light` (1-2 questions, concise), `moderate` (2-3 questions), `deep` (thorough Socratic exploration) |
+| `override`            | (none)     | User-defined behaviour overrides                                                                  |
 
 **Overrides:** This skill supports user-defined overrides. See `/droid` skill § Skill Overrides.
 
@@ -62,6 +63,26 @@ plan → AI scaffolds → human implements → AI coaches → iterate → ship
 
 Run `droid config --get tools.coach` to get the merged configuration.
 
+## Custom Instructions
+
+Any command accepts a ` -- {instruction}` suffix. Split on the **first** ` -- ` (space-dash-dash-space): left is the command and its args, right is additional context or instruction to carry through the entire execution.
+
+Example: `/coach plan add auth endpoint -- treat me as a junior learning OAuth for the first time`
+
+---
+
+## Output Discipline
+
+Before each coaching interaction, read `coaching_intensity` from config (`droid config --get tools.coach`):
+
+| Intensity  | Questions per turn | Response length                         |
+| ---------- | ------------------ | --------------------------------------- |
+| `light`    | 1–2 targeted       | Concise — one short paragraph per point |
+| `moderate` | 2–3 focused        | Brief — 3–5 points, context per question (default) |
+| `deep`     | 3+                 | Thorough — current behaviour            |
+
+**Regardless of intensity:** Prefer one sharp, well-framed question over three surface-level ones. Limit each response to 3–5 focused points rather than exhaustive lists. Quality of challenge over quantity of questions.
+
 ---
 
 ## /coach plan
@@ -70,7 +91,10 @@ Run `droid config --get tools.coach` to get the merged configuration.
 
 **Behaviour:**
 
-- Ratio: ~40% proposing, ~60% questioning
+- Proposing/questioning ratio by intensity:
+  - `light` — ~60% proposing, ~40% questioning (lead with concrete guidance)
+  - `moderate` — ~50% proposing, ~50% questioning (default)
+  - `deep` — ~40% proposing, ~60% questioning (current Socratic-heavy behaviour)
 - Ask questions that probe requirements, edge cases, and design tradeoffs
 - Propose structure but let human refine
 - Offer to create a brain doc: "Would you like me to create a brain doc to capture this plan?"
@@ -135,6 +159,7 @@ Run `droid config --get tools.coach` to get the merged configuration.
 - Add inline `// @{user} {question}` comments using the comments skill pattern
 - Questions should probe reasoning, not just confirm choices
 - Focus on: design decisions, edge cases, potential issues, alternatives
+- Question density follows `coaching_intensity`: `light` → 1–2 comments per changed block; `moderate` → 2–3; `deep` → as many as warranted
 
 **Example inline comments:**
 
@@ -179,6 +204,7 @@ Run `droid config --get tools.coach` to get the merged configuration.
 
 - Identify alternative approaches the human might not have considered
 - Use Socratic prompting to guide discovery
+- Question density follows `coaching_intensity`: `light` → 1–2 sharp challenges; `moderate` → 2–3 challenges; `deep` → thorough exploration
 - Ask questions like:
   - "What if I told you there's a potential issue here? Can you find it?"
   - "I can think of another way to implement this. What might it be?"

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

@@ -1,6 +1,6 @@
 {
   "name": "droid-code-review",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "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.3
+version: 0.2.4
 status: alpha
 
 includes:

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

@@ -18,6 +18,12 @@ Code-review has no configuration of its own. Optional integration with other too
 
 **Overrides:** This skill supports user-defined overrides. See `/droid` skill § Skill Overrides.
 
+## Custom Instructions
+
+Any command accepts a ` -- {instruction}` suffix. Split on the **first** ` -- ` (space-dash-dash-space): left is the command and its args, right is additional context or instruction to carry through the entire execution.
+
+Example: `/code-review #123 -- pay close attention to SQL injection risks`
+
 ## 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.3.0",
+  "version": "0.3.1",
   "description": "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Self-describing: structure and workflows defined in codex repo. 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. Self-describing: structure and workflows defined in codex repo. Use when loading project context, searching codex, capturing decisions, or creating new entries."
-version: 0.3.0
+version: 0.3.1
 status: beta
 
 includes: