@orderful/droid 0.35.4 → 0.36.0

package/.claude-plugin/marketplace.json

@@ -60,8 +60,8 @@
     },
     {
       "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.2",
+      "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",

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @orderful/droid
 
+## 0.36.0
+
+### Minor Changes
+
+- [#225](https://github.com/Orderful/droid/pull/225) [`d6e3fea`](https://github.com/Orderful/droid/commit/d6e3fea047a45d66d46301c7fba253aa0ab3680e) Thanks [@frytyler](https://github.com/frytyler)! - **codex tool: self-describing integration**
+
+  The codex skill now reads structure and workflows from the codex repo's .codex/ folder instead of hardcoded assumptions. This makes the skill stable and rarely needing updates when the codex structure evolves.
+
+  **Changes:**
+  - Skill reads .codex/manifest.yaml for structure definitions
+  - Skill reads .codex/workflows/\*.md for operation instructions
+  - Removed duplicated workflow content from references/
+  - Added references/reading-workflows.md guide
+  - Simplified SKILL.md from 421 to 214 lines (49% reduction)
+  - Kept references/review/ with type-specific facilitation (tech-design, prd)
+  - Added PRD review support
+  - Codex structural changes no longer require droid updates
+
+  **Breaking:** Requires codex repo with .codex/ folder (PR #181)
+
 ## 0.35.4
 
 ### Patch Changes

package/README.md

@@ -59,9 +59,24 @@ When droid auto-updates (or you run `droid update`), the package updates but you
 
 Cursor integration currently requires the **nightly build** of Cursor.
 
+### nodenv/nvm/asdf users
+
+After global npm install, run `nodenv rehash` (or equivalent for your version manager) to update shims.
+
 ## Quick Start
 
-### Option A: Claude Code Plugin (Recommended for Claude Code users)
+### Option A: TUI Dashboard (Recommended)
+
+```bash
+npm install -g @orderful/droid
+droid
+```
+
+The TUI guides you through setup and tool installation. Works with both Claude Code and OpenCode.
+
+### Option B: Claude Code Plugin (Alpha)
+
+> **Note:** Plugin support is experimental. The TUI is more stable and feature-complete.
 
 Install individual tools directly through Claude Code's plugin system:
 
@@ -75,17 +90,6 @@ Install individual tools directly through Claude Code's plugin system:
 /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
-```
-
-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.
-
 ## The TUI
 
 Run `droid` to launch the interactive dashboard:
@@ -109,6 +113,7 @@ Browse available tools, see what's installed, and manage everything from one pla
 | **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 |
@@ -183,15 +188,25 @@ Config lives in `~/.droid/`:
 
 ```
 ~/.droid/
-├── config.yaml                    # Global config
-└── skills/
-    └── {skill}/
-        └── overrides.yaml         # Per-skill overrides
+└── config.yaml                    # Global config (platform, user settings, tool config)
 ```
 
-Tools install to your AI platform's location:
-- **Claude Code**: `~/.claude/skills/`, `~/.claude/commands/`, `~/.claude/agents/`
-- **OpenCode**: `~/.config/opencode/skills/`, `~/.config/opencode/commands/`
+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
+
+**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/` |
 
 ## CLI Reference
 

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

@@ -1,7 +1,7 @@
 {
   "name": "droid-codex",
-  "version": "0.2.2",
-  "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.3.0",
+  "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",
     "url": "https://github.com/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.2
+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
 status: beta
 
 includes:

package/dist/tools/codex/commands/codex.md

@@ -1,6 +1,6 @@
 ---
 name: codex
-description: "Shared organizational knowledge - PRDs, tech designs, patterns, domains, proposals, and explored topics"
+description: "Shared organizational knowledge - PRDs, tech designs, patterns, domains, proposals, and explored topics. Self-describing: structure and workflows defined in codex repo."
 argument-hint: "[projects | search {query} | {category} search {query} | new {category} {name} | decision {text}]"
 ---