@orderful/droid 0.31.1 → 0.31.2

package/src/tools/project/commands/project.md

@@ -1,7 +1,7 @@
 ---
 name: project
 description: "Manage project context files for persistent AI memory across sessions"
-argument-hint: "[{keywords} | update | create {name}]"
+argument-hint: "[search {keywords} | update | create {name}]"
 ---
 
 # /project
@@ -10,21 +10,21 @@ argument-hint: "[{keywords} | update | create {name}]"
 
 **Your task:** Invoke the **project skill** with these arguments.
 
-## Example
+## Examples
 
-If user typed `/project droid`, you should interpret this as: "Search for and load a project matching 'droid'"
-
-If user typed `/project create new-feature`, interpret as: "Create a new project named 'new-feature'"
+- `/project search droid` → Search for and load project matching "droid"
+- `/project search platform -- show changelog` → Search, load, then show changelog
+- `/project update` → Update from conversation context
+- `/project create new-feature` → Create a new project
 
 ## Quick Reference
 
 ```
-/project                    # List and select a project
-/project {keywords}         # SEARCH for existing project (default action)
-/project update             # Update from conversation context
-/project create {name}      # CREATE new project
+/project                            # List and select a project
+/project search {keywords}          # Search for existing project
+/project search {keywords} -- {q}   # Search, load, then execute follow-up
+/project update                     # Update from conversation context
+/project create {name}              # Create new project
 ```
 
-**Default behavior:** When given keywords, SEARCH first (don't create unless "create" keyword is present).
-
-See the **project skill** for complete documentation and procedures.
+See the **project skill** for complete documentation.

package/src/tools/project/skills/project/SKILL.md

@@ -46,19 +46,27 @@ Default `projects_dir` by AI tool (only if overrides.yaml is missing or lacks `p
 | Command                               | Action                                                 |
 | ------------------------------------- | ------------------------------------------------------ |
 | `/project`                            | List and select a project                              |
-| `/project {keywords}`                 | **Search** for existing project (fuzzy-match and load) |
+| `/project search {keywords}`                 | Search for existing project (fuzzy-match and load)     |
+| `/project search {keywords} -- {instruction}` | Search, load, then execute follow-up instruction      |
 | `/project create {name}`              | Create new project (requires `create` keyword)         |
 | `/project create --from codex:{name}` | Create project seeded with codex context               |
 | `/project update`                     | Update from conversation context                       |
 
-**IMPORTANT:** The default action for `/project {keywords}` is to **SEARCH** for existing projects, NOT create. Only use `/project create {name}` when the user explicitly wants to create a new project.
+**IMPORTANT:** Use `/project search {keywords}` to find and load existing projects. Only use `/project create {name}` when the user explicitly wants to create a new project.
 
 ## Loading a Project
 
-**Trigger:** `/project {keywords}` or user asks to load/open a project
+**Trigger:** `/project search {keywords}` or user asks to load/open a project
 
 **TLDR:** Search for and load an existing project. Fuzzy-match keywords against project folders, read PROJECT.md, summarize context.
 
+**Follow-up instructions:** Use `--` to add an instruction to execute after loading:
+```bash
+/project search droid -- show the changelog
+/project search platform -- what's the current status?
+```
+Parse args by splitting on ` -- `. First part = search terms, second part = instruction to execute after loading.
+
 Full procedure: `references/loading.md`
 
 ## Updating a Project
@@ -86,7 +94,7 @@ Templates: `references/templates.md`
 
 Projects work best in a cycle:
 
-1. **Load** - `/project {name}` gives Claude full context
+1. **Load** - `/project search {name}` gives Claude full context
 2. **Research/Plan** - Explore the problem, consider approaches
 3. **Document** - Capture decisions in PROJECT.md before implementing
 4. **Implement** - Build with full context of why decisions were made

package/src/tools/project/skills/project/references/creating.md

@@ -123,7 +123,7 @@ Bridge shared organizational knowledge (codex) to personal working memory (proje
    - Technical details from tech design
 
    Full codex docs remain at: {codex_repo}/projects/{name}/
-   Use `/codex {name}` to load the complete shared context.
+   Use `/codex search {name}` to load the complete shared context.
    ```
 
 ### Error Handling
@@ -144,7 +144,7 @@ Try: /project create --from codex:partnership-automation
 A project named "{name}" already exists at {path}.
 
 Options:
-- Load existing: /project {name}
+- Load existing: /project search {name}
 - Use different name: /project create other-name --from codex:{codex-name}
 ```
 

package/src/tools/project/skills/project/references/loading.md

@@ -1,8 +1,8 @@
 # Loading a Project
 
-**Trigger:** `/project {keywords}` or user asks to load/open a project
+**Trigger:** `/project search {keywords}` or `/project search {keywords} -- {instruction}`
 
-**IMPORTANT:** This is a SEARCH operation. When keywords are provided, search for existing projects - do NOT create a new project. Creating requires the explicit `/project create {name}` command.
+**IMPORTANT:** This is a SEARCH operation. The `search` keyword is required. Creating requires the explicit `/project create {name}` command.
 
 ## Procedure
 
@@ -33,10 +33,12 @@
    - Summarize key context (2-3 sentences)
    - Use project contents for all subsequent work in the session
 
+7. **If `-- {instruction}` provided:** Execute the follow-up instruction against the loaded project
+
 ## Example
 
 ```
-User: /project transaction templates
+User: /project search transaction templates
 
 Claude: Found project "transaction-templates". Loading...
 
@@ -46,3 +48,15 @@ This project covers Handlebars templates for EDI transaction generation.
 Key focus areas: template rendering service, permission controls, and
 the upcoming UI for template management.
 ```
+
+**With follow-up instruction:**
+
+```
+User: /project search droid -- show changelog
+
+Claude: Found project "droid". Loading...
+[project context]
+
+Here's the recent changelog:
+[changelog content]
+```

package/src/tools/tech-design/skills/tech-design/references/think.md

@@ -227,7 +227,7 @@ Which would you prefer?
 **If option 3 (create comment):**
 
 ```bash
-# Read user_mention from ~/.droid/config.yaml
+# Get user_mention from: droid config tech-design
 # Add comment to thought doc:
 
 > @{user} Explored events vs polling for status updates