@orderful/droid 0.31.1 → 0.31.2

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.1.7
+version: 0.1.9
 status: beta
 
 includes:

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

@@ -1,7 +1,7 @@
 ---
 name: codex
 description: "Shared organizational knowledge - PRDs, tech designs, patterns, domains, proposals, and explored topics"
-argument-hint: "[projects | domains | proposals | patterns | topics | {name} | search {query} | new {type} {name} | decision {text}]"
+argument-hint: "[projects | search {query} | {category} search {query} | new {category} {name} | decision {text}]"
 ---
 
 # /codex
@@ -12,20 +12,23 @@ argument-hint: "[projects | domains | proposals | patterns | topics | {name} | s
 
 ## Examples
 
-- `/codex projects` → List all projects in the codex
-- `/codex transaction-templates` → Load the transaction-templates entry
-- `/codex search webhook` → Search for "webhook" across all codex content
-- `/codex new project billing-v2` → Create new project scaffolding
-- `/codex decision "Use PostgreSQL for audit log"` → Append decision to active project
+- `/codex projects` → List all projects
+- `/codex search transaction-templates` → Search and load entry
+- `/codex search webhook -- summarize` → Search, load, then execute follow-up
+- `/codex topics search auth` → Search within topics only
+- `/codex new project billing-v2` → Create new project
+- `/codex decision "Use PostgreSQL"` → Append to active project's DECISIONS.md
 
 ## Quick Reference
 
 ```
-/codex                      # Show categories overview
-/codex {name}               # Load entry (searches all categories)
-/codex search {query}       # Search across everything
-/codex new project {name}   # Scaffold new project
-/codex decision {text}      # Append to active project's DECISIONS.md
+/codex                              # Show categories overview
+/codex {category}                   # List entries (projects, domains, etc.)
+/codex search {query}               # Search across all categories
+/codex search {query} -- {instr}    # Search, load, then execute instruction
+/codex {category} search {query}    # Search within specific category
+/codex new {category} {name}        # Create entry (project/domain/topic/etc.)
+/codex decision {text}              # Append to active project
 ```
 
-See the **codex skill** for complete documentation and procedures.
+See the **codex skill** for complete documentation.

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

@@ -169,22 +169,32 @@ The codex has five categories:
 | `/codex domains`                       | List all domains                                |
 | `/codex proposals`                     | List all proposals                              |
 | `/codex patterns`                      | List all patterns                               |
-| `/codex topics`                        | List all topics                                 |
-| `/codex {name}`                        | Load entry (searches all categories)            |
-| `/codex search {query}`                | Search across everything                        |
-| `/codex new {name}`                    | Scaffold new project (shorthand)                |
-| `/codex new project {name}`            | Scaffold new project from templates             |
-| `/codex new domain {name}`             | Scaffold new domain entry                       |
-| `/codex new proposal {name}`           | Scaffold new proposal entry                     |
-| `/codex new pattern {name}`            | Scaffold new pattern entry                      |
-| `/codex new topic {name}`              | Scaffold new topic entry                        |
-| `/codex decision {text}`               | Append to active project's DECISIONS.md         |
+| `/codex topics`                              | List all topics                                         |
+| `/codex search {query}`                      | Search and load entry (searches all categories)         |
+| `/codex search {query} -- {instruction}`     | Search, load, then execute follow-up instruction        |
+| `/codex {category} search {query}`           | Search within a specific category only                  |
+| `/codex new {category} {name}`               | Scaffold new entry (project/domain/proposal/pattern/topic) |
+| `/codex decision {text}`                     | Append to active project's DECISIONS.md                 |
 | `/codex snapshot {type} {file} {name}` | Import PDF/markdown to codex (uses agent)       |
 | `/codex artifact {file} {project}`     | Add supporting artifact to project (uses agent) |
 
 ## Loading an Entry
 
-**Trigger:** `/codex {name}` or user asks to load/check codex for something
+**Trigger:** `/codex search {query}` or user asks to load/check codex for something
+
+**Category-scoped search:** Narrow search to a specific category:
+```bash
+/codex topics search auth           # Search within topics only
+/codex patterns search webhook      # Search within patterns only
+/codex projects search transaction  # Search within projects only
+```
+
+**Follow-up instructions:** Use `--` to add an instruction to execute after loading:
+```bash
+/codex search transaction-templates -- summarize the PRD
+/codex topics search auth -- is this still accurate?
+```
+Parse args by splitting on ` -- `. First part = search terms, second part = instruction to execute after loading.
 
 **Procedure:**
 
@@ -257,7 +267,7 @@ codebase_paths:
 
 Scoped operations (`decision`, `snapshot`) require an active project:
 
-- When user loads a project via `/codex {project-name}`, set it as active
+- When user loads a project via `/codex search {project-name}`, set it as active
 - Store active project name in session context
 - If scoped operation called with no active project → show project list, let user pick
 
@@ -352,59 +362,16 @@ Artifacts get lighter frontmatter with `type: artifact` and source like `intervi
 
 ## Creating New Entries
 
-The `/codex new` command scaffolds new entries from templates:
-
-```bash
-/codex new {name}              # Shorthand for new project
-/codex new project {name}      # Explicit project creation
-/codex new domain {name}       # New domain entry
-/codex new proposal {name}     # New proposal entry
-/codex new pattern {name}      # New pattern entry
-/codex new topic {name}        # New topic entry
-```
-
-### Projects
-
-**Trigger:** `/codex new {name}` or `/codex new project {name}`
-
-**Procedure:**
-
-1. **Run `git-start-write`** with branch `codex/new-{name}`
-2. Create `{codex_repo}/projects/{name}/`
-3. Copy templates: PRD.md, TECH-DESIGN.md, DECISIONS.md
-4. Fill in frontmatter with today's date
-5. **Run `git-finish-write`** with appropriate commit message and PR title
+**Trigger:** `/codex new {category} {name}`
 
-### Domains
+**Categories:** `project` | `domain` | `proposal` | `pattern` | `topic`
 
-**Trigger:** `/codex new domain {name}`
-
-**Procedure:**
-
-1. **Run `git-start-write`** with branch `codex/domain-{name}`
-2. Create `{codex_repo}/domains/{name}.md` from template
-3. Fill in frontmatter, guide user through sections
-4. **Run `git-finish-write`** with appropriate commit message and PR title
-
-### Proposals
-
-**Trigger:** `/codex new proposal {name}`
-
-**Procedure:**
-
-1. **Run `git-start-write`** with branch `codex/proposal-{name}`
-2. Create `{codex_repo}/proposals/{name}.md` from template
-3. Fill in frontmatter, guide user through sections
-4. **Run `git-finish-write`** with appropriate commit message and PR title
-
-### Patterns and Topics
-
-**Trigger:** `/codex new pattern {name}` or `/codex new topic {name}`
-
-**Procedure:**
+**Procedure** (same for all categories):
 
-1. **Run `git-start-write`** with branch `codex/{pattern|topic}-{name}`
-2. Create file from template
+1. **Run `git-start-write`** with branch `codex/{category}-{name}`
+2. Create entry from template:
+   - `project` → folder with PRD.md, TECH-DESIGN.md, DECISIONS.md
+   - Others → single file at `{codex_repo}/{category}s/{name}.md`
 3. Fill in frontmatter with today's date
 4. **Run `git-finish-write`** with appropriate commit message and PR title
 
@@ -415,7 +382,7 @@ Full procedure: `references/creating.md`
 The codex holds **shared** organizational knowledge. The `/project` skill holds **personal** working memory.
 
 ```
-/codex transaction-templates              → load shared context
+/codex search transaction-templates       → load shared context
 /project create --from codex:{name}       → seed personal PROJECT.md
 /codex publish                            → promote learnings back (future)
 ```

package/dist/tools/codex/skills/codex/references/creating.md

@@ -5,7 +5,7 @@ Detailed procedure for scaffolding new project entries in the codex.
 ## When to Use
 
 - Starting work on a new feature/project
-- `/codex new {name}` command
+- `/codex new project {name}` command
 - User asks to create a codex entry for something new
 
 ## Procedure
@@ -25,7 +25,7 @@ ls {codex_repo}/projects/ | grep -i {name}
 If exists:
 ```
 A project named '{name}' already exists. Did you mean to load it?
-→ /codex {name}
+→ /codex search {name}
 ```
 
 ### 3. Start Write Operation

package/dist/tools/codex/skills/codex/references/decisions.md

@@ -10,7 +10,7 @@ Detailed procedure for capturing decisions during implementation.
 
 ## Prerequisites
 
-- **Active project** must be set (from previous `/codex {project}` load)
+- **Active project** must be set (from previous `/codex search {project}` load)
 - If no active project, prompt user to select one first
 
 ## Procedure

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

@@ -1,6 +1,6 @@
 {
   "name": "droid",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "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.",
   "author": {
     "name": "Orderful",

package/dist/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 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.2
+version: 0.5.3
 status: beta
 
 # System tool - always stays current regardless of auto-update settings