@orderful/droid 0.37.0 → 0.38.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "droid",
       "description": "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows.",
-      "version": "0.5.3",
+      "version": "0.7.0",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -18,123 +18,6 @@
       "author": {
         "name": "Orderful"
       }
-    },
-    {
-      "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.9",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/brain"
-      },
-      "author": {
-        "name": "Orderful"
-      }
-    },
-    {
-      "name": "droid-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",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/coach"
-      },
-      "author": {
-        "name": "Orderful"
-      }
-    },
-    {
-      "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.3",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/code-review"
-      },
-      "author": {
-        "name": "Orderful"
-      }
-    },
-    {
-      "name": "droid-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",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/codex"
-      },
-      "author": {
-        "name": "Orderful"
-      }
-    },
-    {
-      "name": "droid-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.3.5",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/comments"
-      },
-      "author": {
-        "name": "Orderful"
-      }
-    },
-    {
-      "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.4",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/plan"
-      },
-      "author": {
-        "name": "Orderful"
-      }
-    },
-    {
-      "name": "droid-project",
-      "description": "Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features.",
-      "version": "0.3.4",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/project"
-      },
-      "author": {
-        "name": "Orderful"
-      }
-    },
-    {
-      "name": "droid-tech-design",
-      "description": "Technical design authoring tool for engineers. Create structured tech design docs with /tech-design start, iterate in brain, publish to codex. Three-document approach: research doc (codebase discoveries) + thought doc (design workspace) + roll-up (clean summary for review).",
-      "version": "0.2.5",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/tech-design"
-      },
-      "author": {
-        "name": "Orderful"
-      }
-    },
-    {
-      "name": "droid-wrapup",
-      "description": "Session wrap-up that captures decisions, learnings, and open items to persistent docs.",
-      "version": "0.1.3",
-      "source": {
-        "source": "github",
-        "repo": "orderful/droid",
-        "path": "src/tools/wrapup"
-      },
-      "author": {
-        "name": "Orderful"
-      }
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -0,0 +1,49 @@
+{
+  "name": "droid",
+  "version": "0.7.0",
+  "description": "AI-powered development tools for Claude Code",
+  "author": {
+    "name": "Orderful",
+    "url": "https://github.com/orderful"
+  },
+  "repository": "https://github.com/orderful/droid",
+  "license": "MIT",
+  "keywords": [
+    "droid",
+    "ai",
+    "tools"
+  ],
+  "skills": [
+    "./src/tools/brain/skills/brain/SKILL.md",
+    "./src/tools/brain/skills/brain-obsidian/SKILL.md",
+    "./src/tools/coach/skills/coach/SKILL.md",
+    "./src/tools/code-review/skills/code-review/SKILL.md",
+    "./src/tools/codex/skills/codex/SKILL.md",
+    "./src/tools/comments/skills/comments/SKILL.md",
+    "./src/tools/droid/skills/droid/SKILL.md",
+    "./src/tools/droid/skills/droid-bootstrap/SKILL.md",
+    "./src/tools/plan/skills/plan/SKILL.md",
+    "./src/tools/project/skills/project/SKILL.md",
+    "./src/tools/tech-design/skills/tech-design/SKILL.md",
+    "./src/tools/wrapup/skills/wrapup/SKILL.md"
+  ],
+  "commands": [
+    "./src/tools/brain/commands/brain.md",
+    "./src/tools/coach/commands/coach.md",
+    "./src/tools/code-review/commands/code-review.md",
+    "./src/tools/codex/commands/codex.md",
+    "./src/tools/comments/commands/comments.md",
+    "./src/tools/droid/commands/setup.md",
+    "./src/tools/plan/commands/plan.md",
+    "./src/tools/project/commands/project.md",
+    "./src/tools/tech-design/commands/tech-design.md",
+    "./src/tools/wrapup/commands/wrapup.md"
+  ],
+  "agents": [
+    "./src/tools/code-review/agents/edi-standards-reviewer.md",
+    "./src/tools/code-review/agents/error-handling-reviewer.md",
+    "./src/tools/code-review/agents/test-coverage-analyzer.md",
+    "./src/tools/code-review/agents/type-reviewer.md",
+    "./src/tools/codex/agents/codex-document-processor.md"
+  ]
+}

package/AGENTS.md

@@ -101,6 +101,9 @@ Things that will bite you if you don't know:
 | Config-first in commands                     | User overrides must take precedence                                   | Always read `~/.droid/skills/{skill}/overrides.yaml` before using defaults |
 | Changeset package name                       | npm package is scoped                                                 | Use `"@orderful/droid"` not `"droid"` in changesets                        |
 | Run build before PR                          | Plugin manifests need regenerating when tools change                  | Run `bun run build` and commit plugin.json files before creating PR        |
+| Marketplace `path` field is ignored          | Claude Code always looks for plugin.json at repo root, not at path    | Must have `.claude-plugin/plugin.json` at repo root for marketplace        |
+| Plugin.json `name` must match install target | Mismatch causes recursive directory nesting and ENAMETOOLONG errors   | If installing `droid-brain`, plugin.json must have `name: "droid-brain"`   |
+| Marketplace testing requires git push        | Local marketplace reads marketplace.json locally but clones from GitHub | Push changes before testing; clearing cache: `rm -rf ~/.claude/plugins/cache/droid` |
 
 ## Testing
 
@@ -163,6 +166,7 @@ Each tool has a specific domain. Know where your feature belongs:
 | `codex`       | Shared org knowledge (PRDs, designs)    | Codex content management, org context           |
 | `comments`    | Inline @mentions in code                | Comment handling, async collaboration           |
 | `droid`       | **Meta-tool only** - updates, discovery | NEVER add skills here - create new tool instead |
+| `plan`        | Task-scoped planning                    | Portable, structured plans                      |
 | `project`     | Personal project context                | Project file management                         |
 | `tech-design` | Tech design authoring                   | Tech design workflows                           |
 | `wrapup`      | Session wrap-up and context capture     | End-of-session persistence, context handoff     |

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @orderful/droid
 
+## 0.38.0
+
+### Minor Changes
+
+- [#229](https://github.com/Orderful/droid/pull/229) [`742c2ef`](https://github.com/Orderful/droid/commit/742c2ef0d2f9ff28eec12d0923eb5c5bdd148dff) Thanks [@yanneg](https://github.com/yanneg)! - Add Claude Code marketplace support:
+  - Add skills, commands, and agents fields to plugin.json manifests (required for Claude Code to discover plugin content)
+  - Add /setup command for post-marketplace configuration
+
+- [#233](https://github.com/Orderful/droid/pull/233) [`1794c20`](https://github.com/Orderful/droid/commit/1794c2020d863561081ba3cb626474cf175df760) Thanks [@frytyler](https://github.com/frytyler)! - Add OpenAI Codex as a supported platform with symlink-based skill installation
+
+- [#237](https://github.com/Orderful/droid/pull/237) [`a1b85f0`](https://github.com/Orderful/droid/commit/a1b85f01365bd39cb8e3f324ca894e4e0271debf) Thanks [@frytyler](https://github.com/frytyler)! - Add skill overrides for user-defined behaviour customisation
+
+  Users can now customize skill behaviour without forking droid:
+  - New `~/.droid/skill_overrides/` directory created during setup
+  - Template file explains format and provides examples
+  - Override files use YAML frontmatter to declare which commands are affected
+  - Droid skill handles registration via `droid config --set`
+  - Brain skill respects search overrides (pilot implementation)
+  - `enabled` flag to toggle overrides on/off without removing config
+
+- [#239](https://github.com/Orderful/droid/pull/239) [`6581cc2`](https://github.com/Orderful/droid/commit/6581cc2c2cf1cab72abd524ce091e7a786f4b146) Thanks [@frytyler](https://github.com/frytyler)! - Improve tech-design workflow with unified folder structure, search command, and draft/ready publish
+  - **Unified folder structure**: All tech design files now in `{brain_dir}/{inbox?}/tech-designs/{name}/` (research.md, thought-doc.md, diagrams all together)
+  - **Search command**: `/tech-design search {term}` finds and resumes existing designs
+  - **Draft publish**: Share work-in-progress for early feedback (copies tech-design/ folder only, creates GitHub draft PR)
+  - **Ready publish**: Complete design with auto-generated rollup (TECH-DESIGN.md + tech-design/ folder, creates regular PR)
+  - **Smart updates**: Update existing draft to ready, or update existing ready design
+  - **Research doc inclusion**: Optional research doc copy to codex for reviewer/LLM context
+  - **Brain files retained**: Never delete working files in brain after publish
+
+### Patch Changes
+
+- [#238](https://github.com/Orderful/droid/pull/238) [`358185e`](https://github.com/Orderful/droid/commit/358185e9ea2709dde6dbb9ca181fbe4b34f79271) Thanks [@frytyler](https://github.com/frytyler)! - Fix OpenCode reading outdated skills from platform-specific directory
+
+  OpenCode checks `~/.config/opencode/skill/` before `~/.claude/skills/`, so old skills there were shadowing updated versions in the unified location. This migration removes ONLY droid-managed skills from OpenCode's platform-specific directory, ensuring OpenCode reads from the unified source of truth.
+
+  Safety: Only deletes skills bundled with droid. User-authored skills are preserved (learned from PR #232).
+
+- [#236](https://github.com/Orderful/droid/pull/236) [`fff41a9`](https://github.com/Orderful/droid/commit/fff41a9b940b4680325dff6f68c88e3bc23d8be8) Thanks [@frytyler](https://github.com/frytyler)! - Auto-sync tools during droid update
+
+  When droid auto-updates (either via TUI or `droid update` command), it now automatically syncs tools after the npm install completes. This ensures users get updated tool manifests without needing to run `droid update --tools` manually.
+
+  The implementation spawns the newly-installed binary to run `droid update --tools`, which has access to the new bundled tool manifests. Respects the `auto_update.tools` setting - if disabled, tools won't sync automatically.
+
 ## 0.37.0
 
 ### Minor Changes

package/README.md

@@ -16,12 +16,12 @@ AI workflow toolkit for sharing tools, commands, and agents across the engineeri
 
 Before installing droid:
 
-| Requirement | Why | Install |
-|-------------|-----|---------|
-| **npm login to @orderful** | Droid is published to our private npm org | `npm login` (use Orderful credentials) |
-| **bun** | Required for `droid exec` scripts | [bun.sh](https://bun.sh) |
-| **gh** (GitHub CLI) | Highly recommended for PR workflows | [cli.github.com](https://cli.github.com) |
-| **Obsidian** | Recommended for brain/codex markdown editing | [obsidian.md](https://obsidian.md) |
+| Requirement                | Why                                          | Install                                  |
+| -------------------------- | -------------------------------------------- | ---------------------------------------- |
+| **npm login to @orderful** | Droid is published to our private npm org    | `npm login` (use Orderful credentials)   |
+| **bun**                    | Required for `droid exec` scripts            | [bun.sh](https://bun.sh)                 |
+| **gh** (GitHub CLI)        | Highly recommended for PR workflows          | [cli.github.com](https://cli.github.com) |
+| **Obsidian**               | Recommended for brain/codex markdown editing | [obsidian.md](https://obsidian.md)       |
 
 ## Setup Gotchas
 
@@ -74,20 +74,16 @@ droid
 
 The TUI guides you through setup and tool installation. Works with both Claude Code and OpenCode.
 
-### Option B: Claude Code Plugin (Alpha)
+### Option B: Claude Code Plugin
 
-> **Note:** Plugin support is experimental. The TUI is more stable and feature-complete.
-
-Install individual tools directly through Claude Code's plugin system:
+Install directly through Claude Code's plugin system:
 
 ```bash
 # Add the Droid marketplace
 /plugin marketplace add orderful/droid
 
-# Install the tools you want
-/plugin install droid-brain@droid
-/plugin install droid-comments@droid
-/plugin install droid-code-review@droid
+# Install all droid tools
+/plugin install droid@droid
 ```
 
 ## The TUI
@@ -108,17 +104,17 @@ Browse available tools, see what's installed, and manage everything from one pla
 
 ## Available Tools
 
-| Tool | Description | Status |
-|------|-------------|--------|
-| **comments** | Inline `@droid`/`@user` conversations in any file | beta |
-| **project** | Persistent project context across sessions | beta |
-| **brain** | Collaborative scratch pad for planning & research | beta |
-| **plan** | Task-scoped planning with portable, structured plans | alpha |
-| **coach** | Learning-mode AI - scaffolds don't implement, questions don't fix | beta |
-| **codex** | Shared organizational knowledge - PRDs, tech designs, patterns | beta |
-| **code-review** | Multi-agent code review with specialized checkers | alpha |
-| **tech-design** | Three-document approach for technical designs | beta |
-| **wrapup** | Session wrap-up that captures decisions to persistent docs | alpha |
+| Tool            | Description                                                       | Status |
+| --------------- | ----------------------------------------------------------------- | ------ |
+| **comments**    | Inline `@droid`/`@user` conversations in any file                 | beta   |
+| **project**     | Persistent project context across sessions                        | beta   |
+| **brain**       | Collaborative scratch pad for planning & research                 | beta   |
+| **plan**        | Task-scoped planning with portable, structured plans              | alpha  |
+| **coach**       | Learning-mode AI - scaffolds don't implement, questions don't fix | beta   |
+| **codex**       | Shared organizational knowledge - PRDs, tech designs, patterns    | beta   |
+| **code-review** | Multi-agent code review with specialized checkers                 | alpha  |
+| **tech-design** | Three-document approach for technical designs                     | beta   |
+| **wrapup**      | Session wrap-up that captures decisions to persistent docs        | alpha  |
 
 ### Comments
 
@@ -188,38 +184,55 @@ Config lives in `~/.droid/`:
 
 ```
 ~/.droid/
-└── config.yaml                    # Global config (platform, user settings, tool config)
+├── config.yaml                    # Global config (platform, user settings, tool config)
+└── skill_overrides/               # User-defined skill behaviour overrides
+    ├── _template.md               # Template and instructions
+    └── {skill}.md                 # Override for specific skill
 ```
 
 Key sections in `config.yaml`:
+
 - `platform` - Primary platform (claude-code, opencode, cursor)
 - `user_mention` - Your @mention for comments (e.g., `@fry`)
 - `tools` - Per-tool configuration (brain paths, codex repo, etc.)
 - `auto_update` - Auto-update settings for app and tools
 - `repos` - Known repositories for context
 
+### Skill Overrides
+
+Customize skill behaviour without forking droid. Create override files in `~/.droid/skill_overrides/` to replace specific commands with your own instructions.
+
+**Example:** Use semantic search with [qmd](https://github.com/qmdnls/qmd) instead of filename matching for `/brain search`:
+
+1. Ask droid: "Create an override for brain search that uses qmd"
+2. Droid creates `~/.droid/skill_overrides/brain.md` with your instructions
+3. Droid registers it in config
+4. Next `/brain search` uses your qmd workflow
+
+See `~/.droid/skill_overrides/_template.md` for format details.
+
 **Where tools install:**
 
 Skills are unified across all platforms to `~/.claude/skills/`. Commands and agents are platform-specific:
 
-| Platform | Skills | Commands | Agents |
-|----------|--------|----------|--------|
-| Claude Code | `~/.claude/skills/` | `~/.claude/commands/` | `~/.claude/agents/` |
-| OpenCode | `~/.claude/skills/` | `~/.config/opencode/command/` | `~/.config/opencode/agent/` |
-| Cursor | `~/.claude/skills/` | `~/.cursor/commands/` | `~/.cursor/agents/` |
+| Platform    | Skills              | Commands                      | Agents                      |
+| ----------- | ------------------- | ----------------------------- | --------------------------- |
+| Claude Code | `~/.claude/skills/` | `~/.claude/commands/`         | `~/.claude/agents/`         |
+| OpenCode    | `~/.claude/skills/` | `~/.config/opencode/command/` | `~/.config/opencode/agent/` |
+| Cursor      | `~/.claude/skills/` | `~/.cursor/commands/`         | `~/.cursor/agents/`         |
 
 ## CLI Reference
 
 While the TUI is the primary interface, direct commands are available:
 
-| Command | Description |
-|---------|-------------|
-| `droid` | Launch TUI dashboard |
-| `droid setup` | Run setup wizard |
-| `droid install <tool>` | Install a tool |
-| `droid uninstall <tool>` | Remove a tool |
-| `droid update` | Update droid and tools |
-| `droid config` | View/edit config |
+| Command                       | Description                        |
+| ----------------------------- | ---------------------------------- |
+| `droid`                       | Launch TUI dashboard               |
+| `droid setup`                 | Run setup wizard                   |
+| `droid install <tool>`        | Install a tool                     |
+| `droid uninstall <tool>`      | Remove a tool                      |
+| `droid update`                | Update droid and tools             |
+| `droid config`                | View/edit config                   |
 | `droid exec <skill> <script>` | Run a skill's deterministic script |
 
 ## Development
@@ -250,6 +263,7 @@ See [AGENTS.md](AGENTS.md) for detailed contributor guidance. Quick overview:
 6. Submit a PR
 
 The build script generates:
+
 - `.claude-plugin/marketplace.json` at repo root (lists all plugins)
 - `src/tools/{name}/.claude-plugin/plugin.json` for each tool