monomind 1.16.6 → 1.16.8

package/packages/@monomind/cli/.claude/commands/workflows/research.md

@@ -0,0 +1,89 @@
+---
+name: workflows:research
+description: Research workflow coordination pattern — mesh swarm for comprehensive exploration using real MCP tools and npx monomind workflow run -t research
+---
+
+# Research Workflow Coordination
+
+Coordinate multi-agent research activities for comprehensive, systematic exploration.
+
+## How to Invoke
+
+```
+Skill("workflows:research")
+```
+
+---
+
+## Quick Start
+
+```bash
+# Run the built-in research workflow
+npx monomind workflow run -t research --task "Analyze modern web framework performance"
+
+# Preview stages without executing
+npx monomind workflow run -t research --dry-run
+
+# Show template details
+npx monomind workflow template show research
+```
+
+## Stages
+
+The `research` template runs these stages:
+1. **Discovery** — Identify sources, gather raw information
+2. **Analysis** — Evaluate and compare findings
+3. **Synthesis** — Combine into coherent conclusions
+4. **Documentation** — Write up findings
+
+Agents: `researcher`, `analyst` (mesh topology for broad coverage)
+
+## MCP Coordination
+
+For custom research coordination via MCP:
+
+```javascript
+// Initialize mesh swarm for broad exploration
+mcp__monomind__swarm_init({
+  topology: "mesh",
+  maxAgents: 5,
+  strategy: "balanced"
+})
+
+// Run the research workflow
+mcp__monomind__workflow_run({
+  template: "research",
+  task: "Research modern web frameworks performance",
+  options: { parallel: true, maxAgents: 4 }
+})
+
+// Store research findings in memory
+mcp__monomind__memory_store({
+  key: "research-web-frameworks-2026",
+  value: "React/Next.js leads for SSR; Astro for static; Svelte for performance",
+  namespace: "research"
+})
+
+// Search past research before starting
+mcp__monomind__memory_search({
+  query: "web framework performance analysis",
+  namespace: "research",
+  limit: 5
+})
+```
+
+## What Claude Code Actually Does
+
+1. **WebSearch** tool — finds relevant resources
+2. **Read** tool — analyzes documentation and code
+3. **Task** tool — spawns parallel research agents for different angles
+4. Synthesizes findings in the conversation
+5. Stores insights in memory for future sessions
+
+The workflow template coordinates the research strategy; Claude Code does the actual searching and reading.
+
+## Related Skills
+
+- `workflows:workflow-execute` — Full workflow run reference
+- `swarm:research` — Direct swarm-based research coordination
+- `memory:memory-search` — Search past research findings

package/packages/@monomind/cli/.claude/commands/workflows/workflow-create.md

@@ -0,0 +1,84 @@
+---
+name: workflows:workflow-create
+description: Create and save custom workflow templates using npx monomind workflow template create — save successful workflows for reuse
+---
+
+# Workflow Create
+
+Create and save custom workflow templates for reuse.
+
+## How to Invoke
+
+```
+Skill("workflows:workflow-create")
+```
+
+---
+
+## CLI Reference
+
+```bash
+# Create a template from a workflow ID
+npx monomind workflow template create --name "my-api-workflow" --workflow wf-abc123
+
+# Create a template from a workflow file
+npx monomind workflow template create --name "deploy-workflow" --file ./workflow.yaml
+
+# List existing templates
+npx monomind workflow template list
+
+# Show a specific template's stages and agents
+npx monomind workflow template show development
+npx monomind workflow template show sparc
+```
+
+## Template Create Flags
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--name` | `-n` | Template name (required) |
+| `--workflow` | `-w` | Workflow ID to save as template |
+| `--file` | `-f` | Workflow file to save as template |
+
+## MCP Tools
+
+```javascript
+// Create a workflow definition
+mcp__monomind__workflow_create({
+  name: "my-workflow",
+  template: "development",
+  task: "Build auth system"
+})
+
+// List available templates
+mcp__monomind__workflow_template({})
+
+// Execute workflow from template
+mcp__monomind__workflow_run({
+  template: "my-workflow",
+  task: "Build feature X"
+})
+```
+
+## Workflow
+
+1. Run a workflow that works well:
+   ```bash
+   npx monomind workflow run -t development --task "Build auth"
+   # Note the workflowId in the output
+   ```
+
+2. Save it as a reusable template:
+   ```bash
+   npx monomind workflow template create --name "auth-workflow" --workflow <workflowId>
+   ```
+
+3. Reuse it:
+   ```bash
+   npx monomind workflow run -t auth-workflow --task "New auth task"
+   ```
+
+## Related Skills
+
+- `workflows:workflow-execute` — Run workflows from templates
+- `workflows:workflow-export` — Browse and manage templates

package/packages/@monomind/cli/.claude/commands/workflows/workflow-execute.md

@@ -0,0 +1,103 @@
+---
+name: workflows:workflow-execute
+description: Run multi-agent workflows using built-in templates (development, research, testing, sparc, security-audit, etc.) via real npx monomind workflow run CLI
+---
+
+# Workflow Execute
+
+Run multi-agent workflows using built-in templates or custom workflow files.
+
+## How to Invoke
+
+```
+Skill("workflows:workflow-execute")
+```
+
+---
+
+## CLI Reference
+
+```bash
+# Run a built-in template
+npx monomind workflow run -t development --task "Build REST API with auth"
+npx monomind workflow run -t research --task "Analyze performance bottlenecks"
+npx monomind workflow run -t testing
+npx monomind workflow run -t security-audit
+npx monomind workflow run -t sparc --task "New payment module"
+
+# Run from a workflow file
+npx monomind workflow run -f ./workflow.yaml
+npx monomind workflow run -f ./workflow.json
+
+# Validate without executing
+npx monomind workflow run -t development --dry-run
+```
+
+## All Flags
+
+| Flag | Short | Default | Description |
+|------|-------|---------|-------------|
+| `--template` | `-t` | — | Built-in template name |
+| `--file` | `-f` | — | Workflow definition file (YAML/JSON) |
+| `--task` | — | — | Task description passed to the workflow |
+| `--parallel` | `-p` | `true` | Enable parallel agent execution |
+| `--max-agents` | `-m` | `5` | Maximum agents to spawn |
+| `--timeout` | — | `30` | Timeout in minutes |
+| `--dry-run` | `-d` | `false` | Validate without executing |
+
+## Built-in Templates
+
+| Template | Stages | Agent Types |
+|----------|--------|-------------|
+| `development` | Planning → Implementation → Testing → Review → Integration | coder, tester, reviewer |
+| `research` | Discovery → Analysis → Synthesis → Documentation | researcher, analyst |
+| `testing` | Unit → Integration → E2E → Performance | tester, coder |
+| `security-audit` | Threat Model → Static → Dynamic → Report | security-architect, auditor |
+| `code-review` | Initial → Security → Quality → Feedback | reviewer, auditor, analyst |
+| `refactoring` | Analysis → Planning → Refactor → Validation | architect, coder, reviewer |
+| `sparc` | Spec → Pseudocode → Architecture → Refinement → Completion | architect, coder, tester, reviewer |
+| `custom` | Define your own | configurable |
+
+## MCP Tools
+
+```javascript
+// Run a workflow
+mcp__monomind__workflow_run({
+  template: "development",
+  task: "Build REST API with auth",
+  options: {
+    parallel: true,
+    maxAgents: 6,
+    timeout: 30,
+    dryRun: false
+  }
+})
+
+// Check workflow status after launch
+mcp__monomind__workflow_status({ workflowId: "wf-123" })
+
+// List all workflows
+mcp__monomind__workflow_list({ status: "running", limit: 10 })
+
+// Stop a running workflow
+mcp__monomind__workflow_cancel({ workflowId: "wf-123" })
+```
+
+## After Launch
+
+Track progress:
+
+```bash
+# Check status by ID (shown after run)
+npx monomind workflow status <workflowId>
+
+# List all running workflows
+npx monomind workflow list --status running
+```
+
+## Related Skills
+
+- `workflows:workflow-create` — Save a custom workflow template
+- `workflows:development` — Development workflow coordination pattern
+- `workflows:research` — Research workflow coordination pattern
+- `swarm:swarm` — Direct swarm init for custom coordination

package/packages/@monomind/cli/.claude/commands/workflows/workflow-export.md

@@ -0,0 +1,90 @@
+---
+name: workflows:workflow-export
+description: Browse, inspect, and manage workflow templates — list built-in templates, show template details and stages, validate workflow files
+---
+
+# Workflow Templates
+
+Browse and manage workflow templates — inspect built-in templates and validate custom workflow files.
+
+## How to Invoke
+
+```
+Skill("workflows:workflow-export")
+```
+
+---
+
+## CLI Reference
+
+```bash
+# List all available templates
+npx monomind workflow template list
+
+# Show details for a specific template (stages, agents, estimated duration)
+npx monomind workflow template show development
+npx monomind workflow template show sparc
+npx monomind workflow template show security-audit
+
+# Validate a custom workflow file
+npx monomind workflow validate -f ./workflow.yaml
+npx monomind workflow validate -f ./workflow.json --strict
+
+# List past workflow runs
+npx monomind workflow list --status completed --limit 20
+npx monomind workflow list --status all
+```
+
+## Built-in Templates Reference
+
+| Template | Stages | Estimated Duration |
+|----------|--------|--------------------|
+| `development` | Planning → Implementation → Testing → Review → Integration | 15-30 min |
+| `research` | Discovery → Analysis → Synthesis → Documentation | 10-20 min |
+| `testing` | Unit → Integration → E2E → Performance | 5-15 min |
+| `security-audit` | Threat Model → Static → Dynamic → Report | 20-40 min |
+| `code-review` | Initial → Security → Quality → Feedback | 10-25 min |
+| `refactoring` | Analysis → Planning → Refactor → Validation | 15-35 min |
+| `sparc` | Spec → Pseudocode → Architecture → Refinement → Completion | 25-45 min |
+| `custom` | Define your own stages | varies |
+
+## MCP Tools
+
+```javascript
+// List templates
+mcp__monomind__workflow_template({})
+
+// List past workflow runs
+mcp__monomind__workflow_list({ status: "completed", limit: 20 })
+
+// Get status of a specific run
+mcp__monomind__workflow_status({ workflowId: "wf-123" })
+```
+
+## Workflow File Format
+
+To create a custom workflow file for use with `workflow run -f`:
+
+```yaml
+name: my-workflow
+stages:
+  - name: Planning
+    agents: [architect]
+  - name: Implementation
+    agents: [coder]
+  - name: Testing
+    agents: [tester]
+  - name: Review
+    agents: [reviewer]
+```
+
+Validate before running:
+
+```bash
+npx monomind workflow validate -f ./my-workflow.yaml --strict
+```
+
+## Related Skills
+
+- `workflows:workflow-execute` — Run workflows from templates
+- `workflows:workflow-create` — Save a custom workflow as a template