@orderful/droid 0.26.0 → 0.27.1

package/dist/tools/project/skills/{droid-project → project}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: droid-project
+name: project
 description: "Persistent project context for AI memory across sessions. Use when working on multi-session features, refactors, or any work that benefits from accumulated context. User prompts like 'load the project', 'update project context', 'what's the current project?'."
 globs:
   - "**/PROJECT.md"
@@ -33,24 +33,25 @@ Chat history disappears. Projects persist.
 - If `projects_dir` is configured → use **ONLY** that path (do NOT also search defaults)
 - If not configured → use the default for current AI tool
 
-| Setting | Default | Description |
-|---------|---------|-------------|
+| Setting        | Default     | Description                                       |
+| -------------- | ----------- | ------------------------------------------------- |
 | `projects_dir` | (see below) | Where projects are stored (use ONE location only) |
-| `preset` | `markdown` | Output format: `markdown` or `obsidian` |
+| `preset`       | `markdown`  | Output format: `markdown` or `obsidian`           |
 
 Default `projects_dir` by AI tool (only if overrides.yaml is missing or lacks `projects_dir`):
+
 - **claude-code**: `~/.claude/projects`
 - **opencode**: `~/.config/opencode/projects`
 
 ## Commands
 
-| Command | Action |
-|---------|--------|
-| `/project` | List and select a project |
-| `/project {keywords}` | **Search** for existing project (fuzzy-match and load) |
-| `/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 |
+| Command                               | Action                                                 |
+| ------------------------------------- | ------------------------------------------------------ |
+| `/project`                            | List and select a project                              |
+| `/project {keywords}`                 | **Search** for existing project (fuzzy-match and load) |
+| `/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.
 

package/dist/tools/tech-design/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-tech-design",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "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).",
   "author": {
     "name": "Orderful",

package/dist/tools/tech-design/TOOL.yaml

@@ -1,14 +1,15 @@
 name: 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.1.0
+version: 0.2.0
 status: beta
 
 includes:
   skills:
-    - name: droid-tech-design
+    - name: tech-design
       required: true
   commands:
-    - tech-design
+    - name: tech-design
+      is_alias: false
   agents: []
 
 dependencies:

package/dist/tools/tech-design/commands/tech-design.md

@@ -1,93 +1,31 @@
 ---
-description: Write, iterate, and publish technical design documents using a two-document approach - messy thought docs in brain, clean roll-ups in codex
+name: tech-design
+description: "Write, iterate, and publish technical design documents using a three-document approach - research doc, thought doc, and roll-up"
 argument-hint: "[start --from codex:{project} | draft [section] | think [topic] | gaps | publish]"
-allowed-tools: [Read, Write, Edit, Glob, Grep, Bash(gh:*), Bash(git:*), Bash(mkdir:*), Task]
 ---
 
 # /tech-design
 
-Entry point for technical design authoring. See the **tech-design skill** for full behavior.
+**User invoked:** `/tech-design $ARGUMENTS`
 
-> Tech designs are where architectural decisions get made. Make them AI-friendly.
-
-## Arguments
-
-$ARGUMENTS
-
-## Why `/tech-design` not `/design`?
-
-Leaves `/design` open for actual design tooling (Figma workflows, design system docs, UI/UX review).
-
-## Prerequisites
-
-Before first use, verify:
-
-1. **Brain configured** - For thought doc drafting
-2. **Codex configured** - For PRD context and publishing
-3. **gh CLI** - For creating PRs
-
-## Usage
-
-```bash
-# Core Authoring (v1)
-/tech-design start --from codex:{project}  # Create thought doc, pull PRD/DESIGN context
-/tech-design draft [section]                # Auto-generate from PRD + codebase research
-/tech-design think [topic]                  # Guided exploration, stress-test ideas
-/tech-design gaps                           # Checklist of missing/empty sections
-/tech-design publish                        # Generate roll-up + thought doc, open PR to codex
-
-# Self-Review & Interaction (v2 - not yet implemented)
-# /tech-design critic [persona]   # Multi-persona review with severity scoring
-# /tech-design respond {question} # Author tool: search thought doc to draft reply
-# /tech-design ask {question}     # Reviewer tool: search both docs to answer questions
-```
-
-## Configuration
-
-Tech-design has no configuration of its own. It delegates to:
-
-- **Brain skill** - Thought doc location (`brain_dir`, `inbox_folder`)
-- **Codex skill** - Repository location (`codex_repo`)
-
-## Behavior
-
-Refer to the tech-design skill for:
-
-- **Starting**: How to create thought doc from codex context
-- **Drafting**: Research-first, structure-second content generation
-- **Thinking**: Guided exploration to stress-test ideas
-- **Gap Analysis**: What sections are missing or empty
-- **Publishing**: Generate clean roll-up and create PR
-
-The skill's `references/` folder contains detailed procedures for each workflow.
-
-## Two-Document Approach
-
-| Document        | Purpose                                 | Location      |
-| --------------- | --------------------------------------- | ------------- |
-| **Thought doc** | Messy iteration, @mentions, exploration | Brain         |
-| **Roll-up**     | Clean, reviewable, decision-focused     | Codex project |
-
-Both documents published to codex on `/tech-design publish` for full transparency.
+**Your task:** Invoke the **tech-design skill** with these arguments.
 
 ## Examples
 
-```bash
-# Start a new tech design from codex project context
-/tech-design start --from codex:transaction-templates
-
-# Draft the entire doc from PRD and codebase research
-/tech-design draft
-
-# Explore a specific idea before committing to it
-/tech-design think "Should we use events or polling for status updates?"
+- `/tech-design start --from codex:billing-v2` → Create research + thought docs from codex project
+- `/tech-design draft rollout` → Auto-generate the rollout section
+- `/tech-design think API design` → Guided exploration of API design, update research doc
+- `/tech-design gaps` → Show checklist of missing/empty sections
+- `/tech-design publish` → Generate roll-up and publish to codex
 
-# Draft just the rollout section
-/tech-design draft rollout
+## Quick Reference
 
-# See what's missing
-/tech-design gaps
-
-# Publish to codex when ready for review
-/tech-design publish
 ```
+/tech-design start --from codex:{project}  # Create research + thought docs
+/tech-design draft [section]               # Auto-generate section
+/tech-design think [topic]                 # Guided exploration
+/tech-design gaps                          # Missing sections checklist
+/tech-design publish                       # Publish to codex
+```
+
+See the **tech-design skill** for complete documentation and procedures.

package/{src/tools/tech-design/skills/droid-tech-design → dist/tools/tech-design/skills/tech-design}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: droid-tech-design
+name: tech-design
 description: "Technical design authoring with three-document approach - research doc (codebase discoveries), thought doc (design iteration), and roll-up (clean summary). Use when writing tech designs, drafting sections, exploring architectural ideas, or publishing to codex. User prompts like 'start tech design for X', 'draft the rollout section', 'let's think through the API design', 'publish this to codex'."
 globs: []
 alwaysApply: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.26.0",
+  "version": "0.27.1",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {

package/src/commands/tui/components/Badge.test.tsx

@@ -29,7 +29,9 @@ describe('Badge', () => {
     const types = ['skill', 'command', 'agent'] as const;
     for (const type of types) {
       const { lastFrame } = render(<Badge type={type} />);
-      expect(lastFrame()).toContain(type.charAt(0).toUpperCase() + type.slice(1));
+      expect(lastFrame()).toContain(
+        type.charAt(0).toUpperCase() + type.slice(1),
+      );
     }
   });
 });
@@ -44,7 +46,7 @@ describe('ComponentBadges', () => {
         { name: 'skill1', required: true },
         { name: 'skill2', required: false },
       ],
-      commands: ['cmd1'],
+      commands: [{ name: 'cmd1', is_alias: false }],
       agents: [],
     },
   };
@@ -63,7 +65,11 @@ describe('ComponentBadges', () => {
   it('renders singular form for single item', () => {
     const singleSkillTool: ToolManifest = {
       ...mockTool,
-      includes: { skills: [{ name: 'skill1', required: true }], commands: [], agents: [] },
+      includes: {
+        skills: [{ name: 'skill1', required: true }],
+        commands: [],
+        agents: [],
+      },
     };
     const { lastFrame } = render(<ComponentBadges tool={singleSkillTool} />);
     expect(lastFrame()).toContain('1 skill');
@@ -82,7 +88,7 @@ describe('ComponentBadges', () => {
       ...mockTool,
       includes: {
         skills: [{ name: 's1', required: true }],
-        commands: ['c1'],
+        commands: [{ name: 'c1', is_alias: false }],
         agents: ['a1'],
       },
     };

package/src/commands/tui.tsx

@@ -14,7 +14,7 @@ import {
 import { configExists, loadConfig, getAutoUpdateConfig } from '../lib/config';
 import { Platform, type ConfigOption, type ToolManifest } from '../lib/types';
 import { getVersion } from '../lib/version';
-import { runToolMigrations } from '../lib/migrations';
+import { runPackageMigrations } from '../lib/migrations';
 import { type Tab, type View } from './tui/types';
 import { colors, MAX_VISIBLE_ITEMS } from './tui/constants';
 import { TabBar } from './tui/components/TabBar';
@@ -72,10 +72,10 @@ function App() {
       },
     });
 
-  // Run droid meta-tool migration on startup (sync installed tools across platforms)
+  // Run droid package migrations on startup (sync installed tools across platforms)
   useEffect(() => {
-    const droidVersion = getVersion();
-    runToolMigrations('droid', droidVersion);
+    const packageVersion = getVersion();
+    runPackageMigrations(packageVersion);
   }, []);
 
   // Auto-update app if enabled and update available

package/src/lib/migrations.ts

@@ -153,6 +153,73 @@ function createPlatformSyncMigration(version: string): Migration {
   };
 }
 
+/**
+ * Migration: Remove droid- prefix from config skill names
+ *
+ * After PR #145, all skill names in tool manifests are unprefixed (brain, codex, etc.)
+ * This migration updates config entries to match:
+ * - droid-brain → brain
+ * - droid-codex → codex
+ * - droid-project → project
+ * - etc.
+ */
+function createConfigSkillNameMigration(version: string): Migration {
+  return {
+    version,
+    description: 'Remove droid- prefix from config skill names',
+    up: () => {
+      const config = loadConfig();
+      let configChanged = false;
+      const originalPlatform = config.platform;
+
+      // Check both platforms
+      for (const platformKey of [Platform.ClaudeCode, Platform.OpenCode]) {
+        if (!config.platforms[platformKey]) continue;
+
+        config.platform = platformKey;
+        const trackedTools = getPlatformTools(config);
+        const skillNames = Object.keys(trackedTools);
+
+        for (const skillName of skillNames) {
+          // Skip if already unprefixed or is the special 'droid' tool
+          if (!skillName.startsWith('droid-') || skillName === 'droid') {
+            continue;
+          }
+
+          const unprefixedName = skillName.replace(/^droid-/, '');
+
+          // Only migrate if unprefixed name doesn't already exist
+          if (!trackedTools[unprefixedName]) {
+            trackedTools[unprefixedName] = trackedTools[skillName];
+            delete trackedTools[skillName];
+            configChanged = true;
+          }
+        }
+
+        if (configChanged) {
+          setPlatformTools(config, trackedTools);
+        }
+      }
+
+      config.platform = originalPlatform;
+      if (configChanged) {
+        saveConfig(config);
+      }
+    },
+  };
+}
+
+/**
+ * Registry of package-level migrations
+ * These run when the @orderful/droid npm package updates
+ * Triggered by package version from package.json (e.g., 0.26.0)
+ * Run at TUI startup
+ */
+const PACKAGE_MIGRATIONS: Migration[] = [
+  createPlatformSyncMigration('0.25.0'),
+  createConfigSkillNameMigration('0.27.0'),
+];
+
 /**
  * Registry of all tool migrations
  * Key: tool name (e.g., "brain", "comments")
@@ -169,8 +236,6 @@ const TOOL_MIGRATIONS: Record<string, Migration[]> = {
   comments: [createConfigDirMigration('droid-comments', '0.2.6')],
   project: [createConfigDirMigration('droid-project', '0.1.5')],
   coach: [createConfigDirMigration('droid-coach', '0.1.3')],
-  // Global migration for the droid meta-tool
-  droid: [createPlatformSyncMigration('0.25.0')],
 };
 
 /**
@@ -185,7 +250,18 @@ export function getToolMigrations(toolName: string): Migration[] {
  */
 export function getLastMigratedVersion(toolName: string): string {
   const config = loadConfig();
-  return config.migrations?.[toolName] ?? '0.0.0';
+
+  // Check new location first
+  if (config.migrations?.tools?.[toolName]) {
+    return config.migrations.tools[toolName];
+  }
+
+  // Fall back to old location (backward compatibility)
+  if (config.migrations && typeof config.migrations[toolName] === 'string') {
+    return config.migrations[toolName] as string;
+  }
+
+  return '0.0.0';
 }
 
 /**
@@ -196,10 +272,22 @@ export function setLastMigratedVersion(
   version: string,
 ): void {
   const config = loadConfig();
+
+  // Ensure new structure exists
   if (!config.migrations) {
     config.migrations = {};
   }
-  config.migrations[toolName] = version;
+  if (!config.migrations.tools) {
+    config.migrations.tools = {};
+  }
+
+  config.migrations.tools[toolName] = version;
+
+  // Clean up old location if it exists
+  if (typeof config.migrations[toolName] === 'string') {
+    delete config.migrations[toolName];
+  }
+
   saveConfig(config);
 }
 
@@ -273,3 +361,65 @@ export function runToolMigrations(
 
   return runMigrations(toolName, lastMigrated, installedVersion);
 }
+
+/**
+ * Run package-level migrations
+ * Call this on TUI startup with package version from package.json
+ */
+export function runPackageMigrations(packageVersion: string): {
+  success: boolean;
+  error?: string;
+} {
+  const config = loadConfig();
+  const lastMigrated = config.migrations?.package ?? '0.0.0';
+
+  // Only run if the package version is newer than last migrated
+  if (compareSemver(packageVersion, lastMigrated) <= 0) {
+    return { success: true };
+  }
+
+  // Filter migrations that need to run
+  const pendingMigrations = PACKAGE_MIGRATIONS.filter((m) => {
+    const afterFrom = compareSemver(m.version, lastMigrated) > 0;
+    const beforeOrAtTo = compareSemver(m.version, packageVersion) <= 0;
+    return afterFrom && beforeOrAtTo;
+  });
+
+  if (pendingMigrations.length === 0) {
+    // No migrations to run, but still update the version marker
+    config.migrations = config.migrations || {};
+    config.migrations.package = packageVersion;
+    saveConfig(config);
+    return { success: true };
+  }
+
+  const configDir = getConfigDir();
+
+  for (const migration of pendingMigrations) {
+    try {
+      migration.up(configDir);
+      logMigration('package', lastMigrated, migration.version, 'OK');
+    } catch (error) {
+      const errorMessage =
+        error instanceof Error ? error.message : String(error);
+      logMigration(
+        'package',
+        lastMigrated,
+        migration.version,
+        'FAILED',
+        errorMessage,
+      );
+      // Don't update version marker on failure - will retry next time
+      return {
+        success: false,
+        error: `Package migration ${migration.version} failed: ${errorMessage}`,
+      };
+    }
+  }
+
+  // All migrations succeeded, update version marker
+  config.migrations = config.migrations || {};
+  config.migrations.package = packageVersion;
+  saveConfig(config);
+  return { success: true };
+}