@orderful/droid 0.31.2 → 0.33.0

package/.claude-plugin/marketplace.json

@@ -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.3",
+      "version": "0.3.5",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -35,7 +35,7 @@
     {
       "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.1",
+      "version": "0.2.3",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -48,7 +48,7 @@
     {
       "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.1",
+      "version": "0.2.2",
       "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.9",
+      "version": "0.1.10",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -74,7 +74,7 @@
     {
       "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.1",
+      "version": "0.3.3",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -84,10 +84,23 @@
         "name": "Orderful"
       }
     },
+    {
+      "name": "droid-plan",
+      "description": "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'.",
+      "version": "0.1.0",
+      "source": {
+        "source": "github",
+        "repo": "orderful/droid",
+        "path": "src/tools/plan"
+      },
+      "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.2",
+      "version": "0.3.3",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -100,7 +113,7 @@
     {
       "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.1",
+      "version": "0.2.3",
       "source": {
         "source": "github",
         "repo": "orderful/droid",
@@ -109,6 +122,19 @@
       "author": {
         "name": "Orderful"
       }
+    },
+    {
+      "name": "droid-wrapup",
+      "description": "Session wrap-up that captures decisions, learnings, and open items to persistent docs.",
+      "version": "0.1.1",
+      "source": {
+        "source": "github",
+        "repo": "orderful/droid",
+        "path": "src/tools/wrapup"
+      },
+      "author": {
+        "name": "Orderful"
+      }
     }
   ]
 }

package/AGENTS.md

@@ -137,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:
@@ -151,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,74 @@
 # @orderful/droid
 
+## 0.33.0
+
+### Minor Changes
+
+- [#199](https://github.com/Orderful/droid/pull/199) [`9416b9c`](https://github.com/Orderful/droid/commit/9416b9c7a0a9f04f34295304fffee9d2d033ee55) Thanks [@frytyler](https://github.com/frytyler)! - feat(tools): add plan tool for task-scoped planning
+
+  New tool for creating structured, portable plans for PRs, tickets, and small features.
+  Lighter-weight than /tech-design, heavier than just doing.
+
+  Commands:
+  - `/plan new {topic}` - Create plan with context loading
+  - `/plan search {topic}` - Find and load existing plan
+  - `/plan check` - Address @droid comments
+  - `/plan ready` - Finalize and validate
+  - `/plan implement` - Execute the plan
+
+### Patch Changes
+
+- [#195](https://github.com/Orderful/droid/pull/195) [`5a02a36`](https://github.com/Orderful/droid/commit/5a02a36b896e2cef5df56b4bbf03b9edf510287f) Thanks [@frytyler](https://github.com/frytyler)! - Add clarification for @mention directionality across all skills that reference comments
+
+  The @mention is the target, not the author:
+  - `> @droid ...` = User asking/telling the AI
+  - `> @user ...` = AI asking/telling the user
+
+  Updated: comments, brain, tech-design, code-review, coach
+
+- [#197](https://github.com/Orderful/droid/pull/197) [`f9949b7`](https://github.com/Orderful/droid/commit/f9949b713602037ca9caa7e1f15b733bef60dadb) Thanks [@frytyler](https://github.com/frytyler)! - Add tech-design and wrapup tools to README
+
+- [#200](https://github.com/Orderful/droid/pull/200) [`012efae`](https://github.com/Orderful/droid/commit/012efae265ef627ab4aaf26cd707c97e00f41570) Thanks [@frytyler](https://github.com/frytyler)! - fix: use `droid config` instead of reading overrides.yaml directly
+
+  All skills now use `droid config <tool>` to get merged configuration instead
+  of reading `~/.droid/skills/<tool>/overrides.yaml` directly. This provides:
+  - Consistent config access across all skills
+  - Global config values (user_mention, ai_mention) automatically included
+  - Single source of truth for configuration logic
+
+  **Updated tools:**
+  - wrapup (v0.1.1): Project file check uses `droid config project`
+  - project (v0.3.3): Removed unsafe defaults, requires explicit `projects_dir`
+  - brain (v0.3.5): All workflows use `droid config brain`
+  - codex (v0.1.10): Uses `droid config codex` for repo path
+  - comments (v0.3.3): Uses `droid config comments` for settings
+  - coach (v0.2.3): Uses `droid config coach` for settings
+  - tech-design (v0.2.3): Checks brain/codex config via `droid config`
+
+  Fixes #198
+
+## 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

package/README.md

@@ -65,6 +65,8 @@ Browse available tools, see what's installed, and manage everything from one pla
 | **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 |
+| **tech-design** | Three-document approach for technical designs | beta |
+| **wrapup** | Session wrap-up that captures decisions to persistent docs | alpha |
 
 ### Comments
 
@@ -106,6 +108,28 @@ Run comprehensive reviews with specialized agents:
 /code-review path/to/file   # Review specific file
 ```
 
+### Tech Design
+
+Three-document approach for technical designs (requires brain + codex):
+
+```bash
+/tech-design start auth-refactor   # Start a new tech design
+/tech-design draft api             # Draft a section
+/tech-design publish               # Publish roll-up to codex
+```
+
+Creates: research doc (codebase discoveries) → thought doc (design workspace) → roll-up (clean summary).
+
+### Wrapup
+
+Capture session context before ending:
+
+```bash
+/wrapup                     # Run session wrap-up
+```
+
+Extracts decisions, learnings, and open items to project files and brain docs.
+
 ## Configuration
 
 Config lives in `~/.droid/`: