@orderful/droid 0.25.2 → 0.27.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,114 @@
+{
+  "name": "droid",
+  "description": "AI-powered development tools for Claude Code",
+  "owner": {
+    "name": "Orderful",
+    "url": "https://github.com/orderful"
+  },
+  "plugins": [
+    {
+      "name": "droid",
+      "description": "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools.",
+      "version": "0.4.0",
+      "source": {
+        "source": "github",
+        "repo": "orderful/droid",
+        "path": "src/tools/droid"
+      },
+      "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.0",
+      "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.0",
+      "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.0",
+      "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. Use when loading project context, searching codex, capturing decisions, or creating new entries.",
+      "version": "0.1.6",
+      "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.0",
+      "source": {
+        "source": "github",
+        "repo": "orderful/droid",
+        "path": "src/tools/comments"
+      },
+      "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.0",
+      "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.0",
+      "source": {
+        "source": "github",
+        "repo": "orderful/droid",
+        "path": "src/tools/tech-design"
+      },
+      "author": {
+        "name": "Orderful"
+      }
+    }
+  ]
+}

package/.github/workflows/ci.yml

@@ -50,3 +50,23 @@ jobs:
 
       - name: Lint
         run: bun run lint
+
+  plugin-manifests:
+    name: Plugin Manifests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Check plugin manifests are up-to-date
+        run: |
+          bun run build:plugins
+          git diff --exit-code .claude-plugin/ src/tools/*/.claude-plugin/

package/AGENTS.md

@@ -50,12 +50,13 @@ src/
 
 We use **two** terminal UI libraries for different purposes:
 
-| Library | Purpose | Used In |
-|---------|---------|---------|
-| **Ink** | Full React-based TUI dashboard | `tui.tsx`, `tui/components/`, `tui/views/` |
+| Library      | Purpose                                     | Used In                                    |
+| ------------ | ------------------------------------------- | ------------------------------------------ |
+| **Ink**      | Full React-based TUI dashboard              | `tui.tsx`, `tui/components/`, `tui/views/` |
 | **Inquirer** | Simple CLI prompts (select, confirm, input) | `skills.ts`, `setup.ts`, `skill-config.ts` |
 
 **Why both?**
+
 - **Ink** is for the interactive dashboard—stateful, component-based, keyboard navigation
 - **Inquirer** is for quick sequential prompts ("Which tool?", "Configure now? y/n")
 
@@ -78,13 +79,12 @@ Don't consolidate them. Using Ink for simple prompts would be overkill.
 
 Things that will bite you if you don't know:
 
-| Gotcha | Why | What to do |
-|--------|-----|------------|
-| Single-line YAML descriptions | Claude Code's frontmatter parser doesn't handle multiline YAML (`>-`) | Use single-line quoted strings in frontmatter |
-| Skill directories have `droid-` prefix | Workaround for Claude Code bug where directories matching command names block invocation | Name skill dirs `droid-{name}/`, commands stay as `{name}.md` |
-| Bump tool version when skill content changes | Users won't get updates otherwise | Patch bump the tool's TOOL.yaml version |
-| 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 |
+| Gotcha                                       | Why                                                                   | What to do                                                                 |
+| -------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| Single-line YAML descriptions                | Claude Code's frontmatter parser doesn't handle multiline YAML (`>-`) | Use single-line quoted strings in frontmatter                              |
+| Bump tool version when skill content changes | Users won't get updates otherwise                                     | Patch bump the tool's TOOL.yaml version                                    |
+| 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                        |
 
 ## Testing
 
@@ -96,6 +96,7 @@ bun run screenshot      # On-demand TUI screenshot for visual verification
 ```
 
 **When to run what:**
+
 - Changed core logic (`lib/`) → `bun test src/`
 - Changed TUI components → `bun run test:tui`
 - Visual changes you want to verify → `bun run screenshot`
@@ -107,7 +108,7 @@ bun run screenshot      # On-demand TUI screenshot for visual verification
 2. Add `SKILL.md` with frontmatter:
    ```yaml
    ---
-   name: droid-{skill}
+   name: { skill }
    description: "{What it does}. Use when {scenarios}. User prompts like {examples}."
    globs: []
    alwaysApply: false
@@ -120,14 +121,70 @@ bun run screenshot      # On-demand TUI screenshot for visual verification
 
 **Optional:** Add `references/` for context files, `scripts/` for deterministic CLI scripts.
 
+## Existing Tools
+
+Each tool has a specific domain. Know where your feature belongs:
+
+| Tool          | Purpose                                 | Add skills here when...                         |
+| ------------- | --------------------------------------- | ----------------------------------------------- |
+| `brain`       | Personal scratchpad, planning docs      | Working with brain vault, planning, research    |
+| `coach`       | Learning-mode assistance                | Educational interactions, scaffolding           |
+| `code-review` | PR and code review                      | Review-related features                         |
+| `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 |
+| `project`     | Personal project context                | Project file management                         |
+| `tech-design` | Tech design authoring                   | Tech design workflows                           |
+
+> **Important:** The `droid` tool is special. It only handles update awareness and tool discovery.
+> If you're building a full-featured capability (like tech-design, codex, brain), create a **new tool**.
+
+## Adding a New Tool
+
+Create a new tool when the feature:
+
+- Has its own user-facing identity (e.g., `/tech-design`, `/deploy`)
+- Doesn't naturally belong to an existing tool's domain
+- Needs its own versioning/release cycle
+- Is a full authoring/workflow tool (not just a helper)
+
+**Steps:**
+
+1. Create directory: `src/tools/{tool}/`
+2. Add `TOOL.yaml`:
+
+   ```yaml
+   name: { tool }
+   description: "What this tool does"
+   version: 0.1.0
+   status: beta
+
+   includes:
+     skills:
+       - name: { tool }
+         required: true
+     commands:
+       - name: { tool }
+         required: false
+     agents: []
+
+   dependencies: []
+   ```
+
+3. Create skill: `src/tools/{tool}/skills/{tool}/SKILL.md`
+4. Create command: `src/tools/{tool}/commands/{tool}.md`
+5. Add changeset: `.changeset/{tool}-initial.md`
+
+**Example:** See `src/tools/codex/` or `src/tools/brain/` for reference.
+
 ## Key Architecture Decisions
 
 Decisions that affect how you work:
 
-| Decision | Rationale |
-|----------|-----------|
-| "Scripts" not "tools" for skill CLIs | Avoids terminology collision—droid "tools" are packages, skill "scripts" are executables |
-| Parallel skills (`{skill}-next`) for risky refactors | Dogfood new implementation alongside original, swap when confident |
-| Each .md owns its metadata | Single source of truth per artifact, contributors can bring existing skills as-is |
-| Ink + Inquirer (not consolidated) | Ink for stateful TUI, Inquirer for simple prompts—right tool for each job |
-| Collision detection over prefixing | Detect conflicts at install time rather than polluting command names with prefixes |
+| Decision                                             | Rationale                                                                                |
+| ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| "Scripts" not "tools" for skill CLIs                 | Avoids terminology collision—droid "tools" are packages, skill "scripts" are executables |
+| Parallel skills (`{skill}-next`) for risky refactors | Dogfood new implementation alongside original, swap when confident                       |
+| Each .md owns its metadata                           | Single source of truth per artifact, contributors can bring existing skills as-is        |
+| Ink + Inquirer (not consolidated)                    | Ink for stateful TUI, Inquirer for simple prompts—right tool for each job                |
+| Collision detection over prefixing                   | Detect conflicts at install time rather than polluting command names with prefixes       |

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # @orderful/droid
 
+## 0.27.0
+
+### Minor Changes
+
+- [#145](https://github.com/Orderful/droid/pull/145) [`8bce17d`](https://github.com/Orderful/droid/commit/8bce17d98824e796573db1f8a640a8af786fc2d1) Thanks [@frytyler](https://github.com/frytyler)! - Remove droid- prefix from skills and fix command argument passing
+
+  **Breaking internal changes:**
+  - Skills renamed: `droid-brain` → `brain`, `droid-comments` → `comments`, etc.
+  - All skill directories now use unprefixed names
+  - Automatic cleanup removes old `droid-*` directories on upgrade
+
+  **Command improvements:**
+  - Commands now use explicit instruction pattern for better argument passing in OpenCode
+  - Each command file includes examples and quick reference
+  - Alias commands (e.g., `/scratchpad`) properly documented as aliases
+
+  **Platform compatibility:**
+  - OpenCode: Receives all commands (for autocomplete)
+  - Claude Code: Receives only alias commands (relies on unified skills/commands)
+  - Both platforms get unprefixed skill names
+
+  Tools updated: brain, coach, code-review, codex, comments, project, tech-design
+
+### Patch Changes
+
+- [#146](https://github.com/Orderful/droid/pull/146) [`2c87b87`](https://github.com/Orderful/droid/commit/2c87b874a38b0f52d1edf77b2995e565f155f251) Thanks [@frytyler](https://github.com/frytyler)! - fix(codex): make CONTEXT.md generation synchronous by default with optional async
+
+  Changed auto-generation from async-only (with background agents) to flexible approach where LLM can choose synchronous (works everywhere) or asynchronous (Claude Code only). This fixes the issue where CONTEXT.md files were never being generated because background agents weren't working reliably.
+
+## 0.26.0
+
+### Minor Changes
+
+- [#128](https://github.com/Orderful/droid/pull/128) [`7e6f0f6`](https://github.com/Orderful/droid/commit/7e6f0f623f711738f80615851a3e3e3e8d1b9a2d) Thanks [@yanneg](https://github.com/yanneg)! - Add Claude Code native plugin support - tools can now be installed via /plugin commands
+
+- [#134](https://github.com/Orderful/droid/pull/134) [`e3e420c`](https://github.com/Orderful/droid/commit/e3e420c47172d947a1e668917cec400c36920380) Thanks [@frytyler](https://github.com/frytyler)! - Add tech-design skill Phase 1 foundation - skill, command, and templates for writing technical design documents with two-document approach (thought docs in brain, roll-ups in codex).
+
+- [#136](https://github.com/Orderful/droid/pull/136) [`6658faa`](https://github.com/Orderful/droid/commit/6658faabeec099fdd046529519bbb96a9ebf198c) Thanks [@frytyler](https://github.com/frytyler)! - Add tech-design skill Phase 2 - Core authoring workflows with detailed procedure docs for start, draft, think, gaps, and publish commands.
+
+### Patch Changes
+
+- [#137](https://github.com/Orderful/droid/pull/137) [`b01e55b`](https://github.com/Orderful/droid/commit/b01e55b5bf896929f67242c20b1baec3eddf7af9) Thanks [@frytyler](https://github.com/frytyler)! - Add tool inventory and "Adding a New Tool" section to AGENTS.md. Fix allowed-tools format for OpenCode compatibility.
+  - Documents when to create a new tool vs add a skill to an existing tool
+  - Clarifies that `droid` is a meta-tool only
+  - Converts `allowed-tools` from comma-separated strings to YAML arrays (OpenCode requires arrays)
+
+- [#142](https://github.com/Orderful/droid/pull/142) [`f362e32`](https://github.com/Orderful/droid/commit/f362e32f5be05d2506fd62f4dfa1f79204661195) Thanks [@frytyler](https://github.com/frytyler)! - Fix skill configuration to always create overrides.yaml file.
+  - Skills expect overrides.yaml to exist, even with all defaults
+  - Changed promptForSkillConfig to always save the file when config schema exists
+  - Saves all values (including defaults) instead of filtering them out
+  - Fixes bug where codex and other skills fail when overrides file missing
+  - Bump codex tool to v0.1.5
+
+- [#144](https://github.com/Orderful/droid/pull/144) [`fde1504`](https://github.com/Orderful/droid/commit/fde1504edae97a8df14c67a7c5aaa8eb8b550513) Thanks [@frytyler](https://github.com/frytyler)! - Fix dependency check for tools with droid- prefixed skills. Coach tool now correctly detects when the comments tool is installed, resolving "Missing dependency" error when comments was actually installed.
+
+- [#138](https://github.com/Orderful/droid/pull/138) [`d03c576`](https://github.com/Orderful/droid/commit/d03c5767f7d6b5f885c29ec252b1ee688abdb419) Thanks [@frytyler](https://github.com/frytyler)! - Move tech-design from droid tool to standalone tool
+
+  Restructures tech-design as a standalone tool at `src/tools/tech-design/` instead of being bundled under the droid tool. This aligns with the architecture pattern used by brain and codex.
+
+  **What changed:**
+  - Created new `tech-design` tool with its own TOOL.yaml
+  - Moved `droid-tech-design` skill from `tools/droid/skills/` to `tools/tech-design/skills/`
+  - Moved `tech-design` command from `tools/droid/commands/` to `tools/tech-design/commands/`
+  - Removed tech-design entries from droid's TOOL.yaml and dependencies
+
+  **Why this matters:**
+  - tech-design has its own user-facing identity (`/tech-design`)
+  - Doesn't belong to droid's domain (droid = updates/discovery only)
+  - Needs independent versioning/release cycle
+  - Matches pattern of other full-featured authoring tools (codex, brain, code-review)
+
+  **Note:** No user impact since tech-design hasn't been released yet. This is a pre-release structural fix.
+
 ## 0.25.2
 
 ### Patch Changes

package/README.md

@@ -14,12 +14,28 @@ AI workflow toolkit for sharing tools, commands, and agents across the engineeri
 
 ## Quick Start
 
+### Option A: Claude Code Plugin (Recommended for Claude Code users)
+
+Install individual tools 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
+```
+
+### Option B: TUI Dashboard (For OpenCode or if you prefer a visual interface)
+
 ```bash
 npm install -g @orderful/droid
 droid
 ```
 
-That's it. The TUI guides you through setup and tool installation.
+The TUI guides you through setup and tool installation. Works with both Claude Code and OpenCode.
 
 > **Note for nodenv/nvm/asdf users:** After global install, run `nodenv rehash` (or equivalent) to update your shims.
 
@@ -128,9 +144,12 @@ cd droid && bun install
 bun run build
 bun dist/bin/droid.js
 
-# to test
+# to test TUI
 bun link
-bun unlink 
+bun unlink
+
+# to build plugin packages
+bun run build:plugins
 ```
 
 ### Adding Tools
@@ -141,7 +160,14 @@ See [AGENTS.md](AGENTS.md) for detailed contributor guidance. Quick overview:
 2. Add skills in `src/tools/{name}/skills/{skill}/SKILL.md` (frontmatter + instructions)
 3. Add commands in `src/tools/{name}/commands/{command}.md` (frontmatter + instructions)
 4. Add agents in `src/tools/{name}/agents/{agent}.md` (frontmatter + instructions)
-5. Submit a PR
+5. Run `bun run build:plugins` to generate plugin manifests
+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
+
+These must be committed for plugin installation to work.
 
 ## License