convoke-agents 3.2.0 → 3.2.1

package/README.md

@@ -10,7 +10,7 @@
                 Agent teams for complex systems
 ```
 
-[![Version](https://img.shields.io/badge/version-3.1.0-blue)](https://github.com/amalik/convoke-agents)
+[![Version](https://img.shields.io/badge/version-3.2.0-blue)](https://github.com/amalik/convoke-agents)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 </div>
@@ -22,11 +22,11 @@ Convoke extends AI agents with two types of installable modules: **Teams** bring
 | **Vortex** | 7 agents, 22 workflows | Product discovery — from user insight to evidence-based decisions |
 | **Gyre** | 4 agents, 7 workflows | Production readiness — from stack detection to gap analysis |
 
-### What's New
+### What's New in 3.2
 
-- **Gyre team** — 4 agents analyze your project's production readiness: detect your stack, model what "ready" looks like, find what's missing, and help you act on it
-- **Team Factory** — guided workflow for creating new BMAD-compliant teams from scratch (`/bmad-team-factory`)
-- **Skill Validator** — new `validateSkill()` quality gate in the update system for factory-generated skills ([development docs](docs/development.md))
+- **Portable skills** — export any BMAD skill to a standalone format with platform adapters for Claude, Copilot, and Cursor (`npx convoke-export <skill>`)
+- **Team Factory ships** — the module for creating new BMAD-compliant teams is now included in the npm package
+- **1,123 tests** — test infrastructure recovery resolved a phantom-test bug class; test gate tripled from 320+ to 1,123 verified-passing tests
 - See the [CHANGELOG](CHANGELOG.md) for the full release details
 
 ---
@@ -221,6 +221,26 @@ Three capabilities:
 - **Add Agent** — extend an existing team with a new agent
 - **Add Skill** — give an existing agent a new workflow
 
+### Portability — Export Skills Anywhere
+
+Take any BMAD skill and export it to a standalone, LLM-agnostic format that works outside Claude Code:
+
+```bash
+npx convoke-export bmad-brainstorming --output ./exported
+```
+
+The export engine transforms skill workflows into self-contained instruction documents, then generates platform-specific adapter files:
+
+| Platform | Adapter output (written inside the export target) |
+|----------|---------------|
+| Claude | `{target}/CLAUDE.md` commands |
+| GitHub Copilot | `{target}/.github/copilot-instructions.md` |
+| Cursor | `{target}/.cursor/rules/` |
+
+Skills are classified by tier: **standalone** skills export cleanly, **light-deps** skills include dependency notes, and **pipeline** skills (multi-step orchestration) are flagged as non-portable.
+
+Four skills support the workflow: `bmad-export-skill` (export), `bmad-validate-exports` (validate), `bmad-generate-catalog` (catalog README), `bmad-seed-catalog` (full catalog repo).
+
 ### Enhance — Agent Skills
 
 Skills give existing agents new workflows — installed via menu patching, not agent modification. The first skill adds RICE-scored backlog management to the PM agent:
@@ -349,11 +369,17 @@ your-project/
 │   │   ├── contracts/        # Artifact contract schemas (GC1-GC4)
 │   │   ├── guides/           # User guides (all 4 agents)
 │   │   └── config.yaml       # Configuration
-│   └── _enhance/             # Skill: Agent Capability Upgrades
-│       ├── workflows/        # Skill workflows (initiatives-backlog)
-│       ├── extensions/       # Agent menu patch descriptors
-│       ├── guides/           # Module author guide
-│       └── config.yaml       # Configuration
+│   ├── _enhance/             # Skill: Agent Capability Upgrades
+│   │   ├── workflows/        # Skill workflows (initiatives-backlog)
+│   │   ├── extensions/       # Agent menu patch descriptors
+│   │   ├── guides/           # Module author guide
+│   │   └── config.yaml       # Configuration
+│   ├── _portability/         # Skill: Export skills to other platforms
+│   │   └── skills/           # Export, validate, catalog, seed workflows
+│   ├── _team-factory/        # Skill: Create new BMAD-compliant teams
+│   │   └── lib/              # Factory generators and validators
+│   └── _artifacts/           # Skill: Artifact governance & portfolio
+│       └── workflows/        # Migrate artifacts, portfolio status
 └── _bmad-output/
     ├── vortex-artifacts/     # Vortex generated artifacts
     └── gyre-artifacts/       # Gyre generated artifacts
@@ -419,6 +445,7 @@ See [UPDATE-GUIDE.md](UPDATE-GUIDE.md) for migration paths and troubleshooting.
 - **v1.x** — Vortex foundation: 7 agents, 22 workflows, update system, CI/CD
 - **v2.0** — Product renamed to Convoke. CLI commands: `convoke-*`. Package: `convoke-agents`
 - **v2.x** — Enhance module (Skills architecture, RICE initiatives-backlog), Gyre team (production readiness, 4 agents), Team Factory
+- **v3.x** — Artifact governance, portfolio intelligence, portability system (export to Claude/Copilot/Cursor), 1,123 tests
 - **Next** — Forge (domain knowledge extraction for enterprise brownfield engagements)
 - **Future** — Additional teams, Forge-Gyre integration, cross-team workflows
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convoke-agents",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "Agent teams for complex systems, compatible with BMad Method",
   "main": "index.js",
   "files": [
@@ -78,6 +78,7 @@
   },
   "dependencies": {
     "chalk": "^4.1.2",
+    "convoke-agents": "^3.2.0",
     "fs-extra": "^11.3.3",
     "gray-matter": "^4.0.3",
     "js-yaml": "^4.1.0",

package/scripts/portability/catalog-generator.js

@@ -34,7 +34,7 @@ const INTENT_TO_HEADING = {
   'write-documentation': 'I need to write documentation',
   'plan-your-work': 'I need to plan my work',
   'test-your-code': 'I need to test my code',
-  'discover-product-fit': 'I need to discover product-market fit',
+  'discover-product-fit': 'I need to run continuous product discovery',
   'assess-readiness': 'I need to assess production readiness',
   'meta-platform': null, // excluded from catalog
 };

package/scripts/portability/export-engine.js

@@ -172,6 +172,22 @@ const CIS_SKILL_TO_AGENT = {
   'bmad-cis-problem-solving': 'bmad-cis-agent-creative-problem-solver',
 };
 
+// BME agent short-name mapping (agent-manifest uses short names like "Emma")
+const BME_SKILL_TO_AGENT = {
+  'bmad-agent-bme-contextualization-expert': 'Emma',
+  'bmad-agent-bme-discovery-empathy-expert': 'Isla',
+  'bmad-agent-bme-research-convergence-specialist': 'Mila',
+  'bmad-agent-bme-hypothesis-engineer': 'Liam',
+  'bmad-agent-bme-lean-experiments-specialist': 'Wade',
+  'bmad-agent-bme-production-intelligence-specialist': 'Noah',
+  'bmad-agent-bme-learning-decision-expert': 'Max',
+  'bmad-agent-bme-stack-detective': 'Scout',
+  'bmad-agent-bme-model-curator': 'Atlas',
+  'bmad-agent-bme-readiness-analyst': 'Lens',
+  'bmad-agent-bme-review-coach': 'Coach',
+  'bmad-agent-bme-team-factory': 'Loom Master',
+};
+
 function findAgentMatch(skillName, agents) {
   // Strategy 1: exact name match
   let agent = agents.find((a) => a.name === skillName);
@@ -194,6 +210,13 @@ function findAgentMatch(skillName, agents) {
     if (agent) return agent;
   }
 
+  // Strategy 2c: BME agent short-name mapping (Emma, Isla, Scout, etc.)
+  const bmeShortName = BME_SKILL_TO_AGENT[skillName];
+  if (bmeShortName) {
+    agent = agents.find((a) => a.name === bmeShortName);
+    if (agent) return agent;
+  }
+
   return null;
 }
 
@@ -207,7 +230,7 @@ function findAgentMatch(skillName, agents) {
 function resolvePersonaSummary(skillName, agents) {
   const agent = findAgentMatch(skillName, agents);
   if (agent) {
-    return { name: agent.displayName, icon: agent.icon || '' };
+    return { name: agent.displayName || agent.name, icon: agent.icon || '' };
   }
   return { name: humanizeSkillName(skillName), icon: '🔧' };
 }