@orderful/droid 0.31.1 → 0.32.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.2",
+      "version": "0.5.3",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -22,7 +22,7 @@
     {
       "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.1",
+      "version": "0.3.3",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -61,7 +61,7 @@
     {
       "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.7",
+      "version": "0.1.9",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -87,7 +87,7 @@
     {
       "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.1",
+      "version": "0.3.2",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -109,6 +109,19 @@
       "author": {
         "name": "Orderful"
       }
+    },
+    {
+      "name": "droid-wrapup",
+      "description": "Session wrap-up that captures decisions, learnings, and open items to persistent docs.",
+      "version": "0.1.0",
+      "source": {
+        "source": "github",
+        "repo": "orderful/droid",
+        "path": "src/tools/wrapup"
+      },
+      "author": {
+        "name": "Orderful"
+      }
     }
   ]
 }

package/AGENTS.md

@@ -100,6 +100,7 @@ Things that will bite you if you don't know:
 | 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                        |
+| Run build before PR                          | Plugin manifests need regenerating when tools change                  | Run `bun run build` and commit plugin.json files before creating PR        |
 
 ## Testing
 
@@ -136,6 +137,20 @@ bun run screenshot      # On-demand TUI screenshot for visual verification
 
 **Optional:** Add `references/` for context files, `scripts/` for deterministic CLI scripts.
 
+## Progressive Disclosure in Skills
+
+Keep SKILL.md focused on *what* to do. Move *how* details to `references/`:
+
+| In SKILL.md | In references/ |
+|-------------|----------------|
+| High-level flow | Detailed prompts, templates |
+| Quick reference tables | Full schemas, examples |
+| When/why to use | Implementation details |
+
+**Rule of thumb:** If the main skill exceeds ~100 lines, consider extracting implementation details to references.
+
+**Example:** The `wrapup` skill keeps its 4-phase overview in SKILL.md but moves detailed subagent prompts and output schemas to `references/subagent-prompts.md` and `references/output-schema.md`.
+
 ## Existing Tools
 
 Each tool has a specific domain. Know where your feature belongs:
@@ -150,6 +165,7 @@ Each tool has a specific domain. Know where your feature belongs:
 | `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                           |
+| `wrapup`      | Session wrap-up and context capture     | End-of-session persistence, context handoff     |
 
 > **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**.

package/CHANGELOG.md

@@ -1,5 +1,95 @@
 # @orderful/droid
 
+## 0.32.0
+
+### Minor Changes
+
+- [#191](https://github.com/Orderful/droid/pull/191) [`460239b`](https://github.com/Orderful/droid/commit/460239bc8d5f025fa2fd865355aa8b1e09cc0456) Thanks [@frytyler](https://github.com/frytyler)! - Add multi-platform detection and install support
+  - Detect all installed platforms (Claude Code, Cursor, OpenCode) on every install
+  - Add `ignored_platforms` config option to exclude specific platforms
+  - Install commands and agents to all active platforms simultaneously
+  - Show detected platforms with coloured icons in TUI header
+  - Setup wizard now shows all detected platforms and allows excluding some
+
+- [#194](https://github.com/Orderful/droid/pull/194) [`d3cd6f5`](https://github.com/Orderful/droid/commit/d3cd6f5e5273f969b1698886bf812062a3a49cb9) Thanks [@frytyler](https://github.com/frytyler)! - Add `wrapup` tool for session wrap-up
+
+  New standalone tool that captures decisions, learnings, and open items before closing a session.
+  Install with `droid install wrapup`.
+
+  Architecture: context lifeboat pattern
+  - Main agent quickly extracts session context (has conversation history)
+  - Built-in subagents analyse artifacts in fresh context windows
+  - Avoids context pressure / compaction at end of long sessions
+  - Writes to brain docs, project files, or codex on approval
+
+## 0.31.2
+
+### Patch Changes
+
+- [#190](https://github.com/Orderful/droid/pull/190) [`06e1d05`](https://github.com/Orderful/droid/commit/06e1d055e774ff8f996343ca7ca771477e300f7e) Thanks [@frytyler](https://github.com/frytyler)! - Condense skill docs for better context efficiency (Phase 3)
+
+  **droid skill** (450 → 89 lines, 80% reduction):
+  - Removed verbose example dialogues
+  - Condensed to tables + guidelines
+  - LLM generates natural responses from shorter guidance
+
+  **brain skill** (191 → 128 lines, 33% reduction):
+  - User-defined categories: any non-reserved word becomes a category
+  - `/brain spike auth` → `spikes/auth.md` (creates on the fly)
+  - Reserved keywords: `search`, `add`, `check`, `done`
+  - Collapsed repetitive per-category sections into single generic pattern
+
+  **codex skill** (454 → 405 lines, 11% reduction):
+  - Collapsed `/codex new {type}` commands into single pattern
+  - `/codex new {category} {name}` where category = project|domain|proposal|pattern|topic
+  - Removed `/codex new {name}` shorthand - must specify category explicitly
+
+  **Commands updated** to match new patterns:
+  - brain, scratchpad, codex, project commands now use explicit `search` keyword
+  - Added `--` delimiter examples
+  - Added category-scoped search examples for codex
+
+  **brain_dir config:** Removed default - now prompts user to choose location on first use.
+
+  **Reference files updated** to match Phase 1-3 changes:
+  - brain/references/workflows.md - explicit `search`, user-defined categories
+  - brain-obsidian/references/workflows.md - explicit search patterns
+  - codex/references/creating.md, decisions.md - explicit search patterns
+  - project/references/loading.md, creating.md - explicit search patterns, `--` delimiter examples
+
+  **Total savings:** ~470 lines removed across three skills. Smaller docs = more context for actual work.
+
+- [#189](https://github.com/Orderful/droid/pull/189) [`d9917c4`](https://github.com/Orderful/droid/commit/d9917c4630ac5c418d31a332b3114500bfa78fa3) Thanks [@frytyler](https://github.com/frytyler)! - Add search enhancements: `--` delimiter and category-scoped search
+
+  **`--` delimiter for follow-up instructions** (brain, codex, project):
+
+  ```bash
+  /brain search auth refactor -- what's left to do?
+  /project search droid -- show the changelog
+  /codex search transaction -- summarize the PRD
+  ```
+
+  Everything after `--` is executed as a follow-up instruction after loading the doc.
+
+  **Category-scoped search for codex**:
+
+  ```bash
+  /codex topics search auth        # Search within topics only
+  /codex patterns search webhook   # Search within patterns only
+  /codex projects search transaction
+  ```
+
+  Narrows search to a specific category instead of searching all categories.
+
+- [#187](https://github.com/Orderful/droid/pull/187) [`738bcec`](https://github.com/Orderful/droid/commit/738bcec4ffbe8ad5bff6a986838bf26fd6b6544a) Thanks [@frytyler](https://github.com/frytyler)! - Require explicit `search` keyword for /codex, /brain, and /project commands
+
+  Commands that support both reserved keywords and search had ambiguity issues (e.g., `/codex projects` - is this "list projects" or "search for 'projects'"?). This change removes implicit search patterns and requires the explicit `search` keyword:
+  - `/codex search {query}` (was `/codex {name}`)
+  - `/brain search {topic}` (was `/brain {topic}`)
+  - `/project search {keywords}` (was `/project {keywords}`)
+
+  Closes #139
+
 ## 0.31.1
 
 ### Patch Changes