@monoes/monomindcli 1.8.0 → 1.9.0

package/.claude/commands/sparc/integration.md

@@ -1,9 +1,9 @@
 ---
-name: sparc-integration
-description: 🔗 System Integrator - You merge the outputs of all modes into a working, tested, production-ready system. You ensure co...
+name: sparc:integration
+description: System Integrator - You merge the outputs of all modes into a working, tested, production-ready system. You ensure consistency, cohesion, and modularity.
 ---
 
-# 🔗 System Integrator
+# System Integrator
 
 ## Role Definition
 You merge the outputs of all modes into a working, tested, production-ready system. You ensure consistency, cohesion, and modularity.
@@ -18,66 +18,25 @@ Verify interface compatibility, shared modules, and env config standards. Split
 - **mcp**: Model Context Protocol tools
 - **command**: Command execution
 
-## Usage
+## How to Invoke
 
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__monomind__sparc_mode {
-  mode: "integration",
-  task_description: "connect payment service",
-  options: {
-    namespace: "integration",
-    non_interactive: false
-  }
-}
-```
-
-### Option 2: Using NPX CLI (Fallback when MCP not available)
-```bash
-# Use when running from terminal or MCP tools unavailable
-npx monomind sparc run integration "connect payment service"
-
-# For alpha features
-npx monomind@alpha sparc run integration "connect payment service"
-
-# With namespace
-npx monomind sparc run integration "your task" --namespace integration
-
-# Non-interactive mode
-npx monomind sparc run integration "your task" --non-interactive
+In Claude Code, load this mode as a skill:
 ```
-
-### Option 3: Local Installation
-```bash
-# If monomind is installed locally
-./monomind sparc run integration "connect payment service"
+Skill("sparc:integration")
 ```
 
 ## Memory Integration
 
-### Using MCP Tools (Preferred)
 ```javascript
-// Store mode-specific context
-mcp__monomind__memory_usage {
-  action: "store",
-  key: "integration_context",
-  value: "important decisions",
-  namespace: "integration"
-}
+// Store context
+mcp__monomind__memory_store({ key: "integration_context", value: "important decisions", namespace: "integration" })
 
-// Query previous work
-mcp__monomind__memory_search {
-  pattern: "integration",
-  namespace: "integration",
-  limit: 5
-}
+// Search previous work
+mcp__monomind__memory_search({ query: "integration", namespace: "integration", limit: 5 })
 ```
 
-### Using NPX CLI (Fallback)
 ```bash
-# Store mode-specific context
+# CLI equivalents
 npx monomind memory store "integration_context" "important decisions" --namespace integration
-
-# Query previous work
-npx monomind memory query "integration" --limit 5
+npx monomind memory search --query "integration" --namespace integration
 ```

package/.claude/commands/sparc/mcp.md

@@ -1,9 +1,9 @@
 ---
-name: sparc-mcp
-description: ♾️ MCP Integration - You are the MCP (Management Control Panel) integration specialist responsible for connecting to a...
+name: sparc:mcp
+description: MCP Integration - You are the MCP integration specialist responsible for connecting to and managing external services through MCP interfaces.
 ---
 
-# ♾️ MCP Integration
+# MCP Integration
 
 ## Role Definition
 You are the MCP (Management Control Panel) integration specialist responsible for connecting to and managing external services through MCP interfaces. You ensure secure, efficient, and reliable communication between the application and external service APIs.
@@ -52,66 +52,25 @@ For accessing MCP resources, use `access_mcp_resource` with proper URI:
 - **edit**: File modification and creation
 - **mcp**: Model Context Protocol tools
 
-## Usage
+## How to Invoke
 
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__monomind__sparc_mode {
-  mode: "mcp",
-  task_description: "integrate with external API",
-  options: {
-    namespace: "mcp",
-    non_interactive: false
-  }
-}
-```
-
-### Option 2: Using NPX CLI (Fallback when MCP not available)
-```bash
-# Use when running from terminal or MCP tools unavailable
-npx monomind sparc run mcp "integrate with external API"
-
-# For alpha features
-npx monomind@alpha sparc run mcp "integrate with external API"
-
-# With namespace
-npx monomind sparc run mcp "your task" --namespace mcp
-
-# Non-interactive mode
-npx monomind sparc run mcp "your task" --non-interactive
+In Claude Code, load this mode as a skill:
 ```
-
-### Option 3: Local Installation
-```bash
-# If monomind is installed locally
-./monomind sparc run mcp "integrate with external API"
+Skill("sparc:mcp")
 ```
 
 ## Memory Integration
 
-### Using MCP Tools (Preferred)
 ```javascript
-// Store mode-specific context
-mcp__monomind__memory_usage {
-  action: "store",
-  key: "mcp_context",
-  value: "important decisions",
-  namespace: "mcp"
-}
+// Store context
+mcp__monomind__memory_store({ key: "mcp_context", value: "important decisions", namespace: "mcp" })
 
-// Query previous work
-mcp__monomind__memory_search {
-  pattern: "mcp",
-  namespace: "mcp",
-  limit: 5
-}
+// Search previous work
+mcp__monomind__memory_search({ query: "mcp", namespace: "mcp", limit: 5 })
 ```
 
-### Using NPX CLI (Fallback)
 ```bash
-# Store mode-specific context
+# CLI equivalents
 npx monomind memory store "mcp_context" "important decisions" --namespace mcp
-
-# Query previous work
-npx monomind memory query "mcp" --limit 5
+npx monomind memory search --query "mcp" --namespace mcp
 ```

package/.claude/commands/sparc/memory-manager.md

@@ -1,35 +1,18 @@
+---
+name: sparc:memory-manager
+description: Memory Manager - Knowledge management with Memory tools for persistent insights. Organizes, retrieves, and maintains cross-session project context.
+---
+
 # SPARC Memory Manager Mode
 
 ## Purpose
 Knowledge management with Memory tools for persistent insights.
 
-## Activation
+## How to Invoke
 
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__monomind__sparc_mode {
-  mode: "memory-manager",
-  task_description: "organize project knowledge",
-  options: {
-    namespace: "project",
-    auto_organize: true
-  }
-}
+In Claude Code, load this mode as a skill:
 ```
-
-### Option 2: Using NPX CLI (Fallback when MCP not available)
-```bash
-# Use when running from terminal or MCP tools unavailable
-npx monomind sparc run memory-manager "organize project knowledge"
-
-# For alpha features
-npx monomind@alpha sparc run memory-manager "organize project knowledge"
-```
-
-### Option 3: Local Installation
-```bash
-# If monomind is installed locally
-./monomind sparc run memory-manager "organize project knowledge"
+Skill("sparc:memory-manager")
 ```
 
 ## Core Capabilities
@@ -52,3 +35,23 @@ npx monomind@alpha sparc run memory-manager "organize project knowledge"
 - Update knowledge base
 - Merge related information
 - Archive obsolete data
+
+## Real Memory Tools
+
+```javascript
+// Store context
+mcp__monomind__memory_store({ key: "...", value: "...", namespace: "..." })
+
+// Search stored knowledge
+mcp__monomind__memory_search({ query: "...", namespace: "...", limit: 10 })
+
+// List entries
+mcp__monomind__memory_list({ namespace: "..." })
+```
+
+```bash
+# CLI equivalents
+npx monomind memory store "key" "value" --namespace ns
+npx monomind memory search --query "term" --namespace ns
+npx monomind memory list --namespace ns
+```

package/.claude/commands/sparc/optimizer.md

@@ -1,35 +1,18 @@
+---
+name: sparc:optimizer
+description: Optimizer - Performance optimization with systematic analysis and improvements. Profiling, bottleneck identification, and algorithmic enhancement.
+---
+
 # SPARC Optimizer Mode
 
 ## Purpose
 Performance optimization with systematic analysis and improvements.
 
-## Activation
+## How to Invoke
 
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__monomind__sparc_mode {
-  mode: "optimizer",
-  task_description: "optimize application performance",
-  options: {
-    profile: true,
-    benchmark: true
-  }
-}
+In Claude Code, load this mode as a skill:
 ```
-
-### Option 2: Using NPX CLI (Fallback when MCP not available)
-```bash
-# Use when running from terminal or MCP tools unavailable
-npx monomind sparc run optimizer "optimize application performance"
-
-# For alpha features
-npx monomind@alpha sparc run optimizer "optimize application performance"
-```
-
-### Option 3: Local Installation
-```bash
-# If monomind is installed locally
-./monomind sparc run optimizer "optimize application performance"
+Skill("sparc:optimizer")
 ```
 
 ## Core Capabilities

package/.claude/commands/sparc/orchestrator.md

@@ -1,31 +1,18 @@
+---
+name: sparc:orchestrator
+description: Orchestrator - Multi-agent task orchestration with TodoWrite/TodoRead/Task/Memory coordination. Decomposes complex goals into parallel agent tasks.
+---
+
 # SPARC Orchestrator Mode
 
 ## Purpose
-Multi-agent task orchestration with TodoWrite/TodoRead/Task/Memory using MCP tools.
+Multi-agent task orchestration with TodoWrite/TodoRead/Task/Memory using real Claude Code tools.
 
-## Activation
+## How to Invoke
 
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__monomind__sparc_mode {
-  mode: "orchestrator",
-  task_description: "coordinate feature development"
-}
+In Claude Code, load this mode as a skill:
 ```
-
-### Option 2: Using NPX CLI (Fallback when MCP not available)
-```bash
-# Use when running from terminal or MCP tools unavailable
-npx monomind sparc run orchestrator "coordinate feature development"
-
-# For alpha features
-npx monomind@alpha sparc run orchestrator "coordinate feature development"
-```
-
-### Option 3: Local Installation
-```bash
-# If monomind is installed locally
-./monomind sparc run orchestrator "coordinate feature development"
+Skill("sparc:orchestrator")
 ```
 
 ## Core Capabilities
@@ -35,41 +22,34 @@ npx monomind@alpha sparc run orchestrator "coordinate feature development"
 - Progress tracking
 - Result synthesis
 
-## Integration Examples
+## Orchestration Workflow
+
+1. Create plan with TodoWrite
+2. Initialize swarm (if multi-agent)
+3. Spawn specialized agents via Task tool
+4. Monitor via swarm_status
+5. Synthesize results
+
+## Real MCP Tools
 
-### Using MCP Tools (Preferred)
 ```javascript
 // Initialize orchestration swarm
-mcp__monomind__swarm_init {
-  topology: "hierarchical",
-  strategy: "auto",
-  maxAgents: 8
-}
+mcp__monomind__swarm_init({ topology: "hierarchical", strategy: "specialized", maxAgents: 8 })
 
 // Spawn coordinator agent
-mcp__monomind__agent_spawn {
-  type: "coordinator",
-  capabilities: ["task-planning", "resource-management"]
-}
-
-// Orchestrate tasks
-mcp__monomind__task_orchestrate {
-  task: "feature development",
-  strategy: "parallel",
-  dependencies: ["auth", "ui", "api"]
-}
-```
+mcp__monomind__agent_spawn({ type: "coordinator", capabilities: ["task-planning", "resource-management"] })
 
-### Using NPX CLI (Fallback)
-```bash
-# Initialize orchestration swarm
-npx monomind swarm init --topology hierarchical --strategy auto --max-agents 8
+// Coordinate tasks
+mcp__monomind__coordination_orchestrate({ task: "feature development", strategy: "parallel" })
 
-# Spawn coordinator agent
-npx monomind agent spawn --type coordinator --capabilities "task-planning,resource-management"
+// Monitor progress
+mcp__monomind__swarm_status({ swarmId: "current" })
+```
 
-# Orchestrate tasks
-npx monomind task orchestrate --task "feature development" --strategy parallel --deps "auth,ui,api"
+```bash
+# CLI equivalents
+npx monomind swarm init --topology hierarchical --max-agents 8
+npx monomind swarm status
 ```
 
 ## Orchestration Patterns
@@ -79,54 +59,12 @@ npx monomind task orchestrate --task "feature development" --strategy parallel -
 - Event-driven flows
 - Adaptive strategies
 
-## Coordination Tools
-- TodoWrite for planning
-- Task for agent launch
-- Memory for sharing
-- Progress monitoring
-- Result aggregation
+## Memory Integration
 
-## Workflow Example
-
-### Using MCP Tools (Preferred)
 ```javascript
-// 1. Initialize orchestration swarm
-mcp__monomind__swarm_init {
-  topology: "hierarchical",
-  maxAgents: 10
-}
-
-// 2. Create workflow
-mcp__monomind__workflow_create {
-  name: "feature-development",
-  steps: ["design", "implement", "test", "deploy"]
-}
-
-// 3. Execute orchestration
-mcp__monomind__sparc_mode {
-  mode: "orchestrator",
-  options: {parallel: true, monitor: true},
-  task_description: "develop user management system"
-}
-
-// 4. Monitor progress
-mcp__monomind__swarm_monitor {
-  swarmId: "current",
-  interval: 5000
-}
-```
+// Store orchestration state
+mcp__monomind__memory_store({ key: "orchestrator_context", value: "task breakdown", namespace: "orchestrator" })
 
-### Using NPX CLI (Fallback)
-```bash
-# 1. Initialize orchestration swarm
-npx monomind swarm init --topology hierarchical --max-agents 10
-
-# 2. Create workflow
-npx monomind workflow create --name "feature-development" --steps "design,implement,test,deploy"
-
-# 3. Execute orchestration
-npx monomind sparc run orchestrator "develop user management system" --parallel --monitor
-
-# 4. Monitor progress
-npx monomind swarm monitor --interval 5000
-```
+// Search previous patterns
+mcp__monomind__memory_search({ query: "orchestrator", namespace: "orchestrator", limit: 5 })
+```

package/.claude/commands/sparc/post-deployment-monitoring-mode.md

@@ -1,9 +1,9 @@
 ---
-name: sparc-post-deployment-monitoring-mode
-description: 📈 Deployment Monitor - You observe the system post-launch, collecting performance, logs, and user feedback. You flag reg...
+name: sparc:post-deployment-monitoring-mode
+description: Deployment Monitor - You observe the system post-launch, collecting performance, logs, and user feedback. You flag regressions or unexpected behaviors.
 ---
 
-# 📈 Deployment Monitor
+# Deployment Monitor
 
 ## Role Definition
 You observe the system post-launch, collecting performance, logs, and user feedback. You flag regressions or unexpected behaviors.
@@ -18,66 +18,25 @@ Configure metrics, logs, uptime checks, and alerts. Recommend improvements if th
 - **mcp**: Model Context Protocol tools
 - **command**: Command execution
 
-## Usage
+## How to Invoke
 
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__monomind__sparc_mode {
-  mode: "post-deployment-monitoring-mode",
-  task_description: "monitor production metrics",
-  options: {
-    namespace: "post-deployment-monitoring-mode",
-    non_interactive: false
-  }
-}
-```
-
-### Option 2: Using NPX CLI (Fallback when MCP not available)
-```bash
-# Use when running from terminal or MCP tools unavailable
-npx monomind sparc run post-deployment-monitoring-mode "monitor production metrics"
-
-# For alpha features
-npx monomind@alpha sparc run post-deployment-monitoring-mode "monitor production metrics"
-
-# With namespace
-npx monomind sparc run post-deployment-monitoring-mode "your task" --namespace post-deployment-monitoring-mode
-
-# Non-interactive mode
-npx monomind sparc run post-deployment-monitoring-mode "your task" --non-interactive
+In Claude Code, load this mode as a skill:
 ```
-
-### Option 3: Local Installation
-```bash
-# If monomind is installed locally
-./monomind sparc run post-deployment-monitoring-mode "monitor production metrics"
+Skill("sparc:post-deployment-monitoring-mode")
 ```
 
 ## Memory Integration
 
-### Using MCP Tools (Preferred)
 ```javascript
-// Store mode-specific context
-mcp__monomind__memory_usage {
-  action: "store",
-  key: "post-deployment-monitoring-mode_context",
-  value: "important decisions",
-  namespace: "post-deployment-monitoring-mode"
-}
+// Store context
+mcp__monomind__memory_store({ key: "monitoring_context", value: "important decisions", namespace: "monitoring" })
 
-// Query previous work
-mcp__monomind__memory_search {
-  pattern: "post-deployment-monitoring-mode",
-  namespace: "post-deployment-monitoring-mode",
-  limit: 5
-}
+// Search previous work
+mcp__monomind__memory_search({ query: "monitoring", namespace: "monitoring", limit: 5 })
 ```
 
-### Using NPX CLI (Fallback)
 ```bash
-# Store mode-specific context
-npx monomind memory store "post-deployment-monitoring-mode_context" "important decisions" --namespace post-deployment-monitoring-mode
-
-# Query previous work
-npx monomind memory query "post-deployment-monitoring-mode" --limit 5
+# CLI equivalents
+npx monomind memory store "monitoring_context" "important decisions" --namespace monitoring
+npx monomind memory search --query "monitoring" --namespace monitoring
 ```

package/.claude/commands/sparc/refinement-optimization-mode.md

@@ -1,9 +1,9 @@
 ---
-name: sparc-refinement-optimization-mode
-description: 🧹 Optimizer - You refactor, modularize, and improve system performance. You enforce file size limits, dependenc...
+name: sparc:refinement-optimization-mode
+description: Optimizer - You refactor, modularize, and improve system performance. You enforce file size limits, dependency decoupling, and configuration hygiene.
 ---
 
-# 🧹 Optimizer
+# Optimizer
 
 ## Role Definition
 You refactor, modularize, and improve system performance. You enforce file size limits, dependency decoupling, and configuration hygiene.
@@ -18,66 +18,25 @@ Audit files for clarity, modularity, and size. Break large components (>500 line
 - **mcp**: Model Context Protocol tools
 - **command**: Command execution
 
-## Usage
+## How to Invoke
 
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__monomind__sparc_mode {
-  mode: "refinement-optimization-mode",
-  task_description: "optimize database queries",
-  options: {
-    namespace: "refinement-optimization-mode",
-    non_interactive: false
-  }
-}
-```
-
-### Option 2: Using NPX CLI (Fallback when MCP not available)
-```bash
-# Use when running from terminal or MCP tools unavailable
-npx monomind sparc run refinement-optimization-mode "optimize database queries"
-
-# For alpha features
-npx monomind@alpha sparc run refinement-optimization-mode "optimize database queries"
-
-# With namespace
-npx monomind sparc run refinement-optimization-mode "your task" --namespace refinement-optimization-mode
-
-# Non-interactive mode
-npx monomind sparc run refinement-optimization-mode "your task" --non-interactive
+In Claude Code, load this mode as a skill:
 ```
-
-### Option 3: Local Installation
-```bash
-# If monomind is installed locally
-./monomind sparc run refinement-optimization-mode "optimize database queries"
+Skill("sparc:refinement-optimization-mode")
 ```
 
 ## Memory Integration
 
-### Using MCP Tools (Preferred)
 ```javascript
-// Store mode-specific context
-mcp__monomind__memory_usage {
-  action: "store",
-  key: "refinement-optimization-mode_context",
-  value: "important decisions",
-  namespace: "refinement-optimization-mode"
-}
+// Store context
+mcp__monomind__memory_store({ key: "refinement_context", value: "important decisions", namespace: "refinement" })
 
-// Query previous work
-mcp__monomind__memory_search {
-  pattern: "refinement-optimization-mode",
-  namespace: "refinement-optimization-mode",
-  limit: 5
-}
+// Search previous work
+mcp__monomind__memory_search({ query: "refinement", namespace: "refinement", limit: 5 })
 ```
 
-### Using NPX CLI (Fallback)
 ```bash
-# Store mode-specific context
-npx monomind memory store "refinement-optimization-mode_context" "important decisions" --namespace refinement-optimization-mode
-
-# Query previous work
-npx monomind memory query "refinement-optimization-mode" --limit 5
+# CLI equivalents
+npx monomind memory store "refinement_context" "important decisions" --namespace refinement
+npx monomind memory search --query "refinement" --namespace refinement
 ```

package/.claude/commands/sparc/researcher.md

@@ -1,35 +1,18 @@
+---
+name: sparc:researcher
+description: Researcher - Deep research with parallel WebSearch/WebFetch and Memory coordination. Academic papers, industry reports, trend analysis, and competitive research.
+---
+
 # SPARC Researcher Mode
 
 ## Purpose
 Deep research with parallel WebSearch/WebFetch and Memory coordination.
 
-## Activation
+## How to Invoke
 
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__monomind__sparc_mode {
-  mode: "researcher",
-  task_description: "research AI trends 2024",
-  options: {
-    depth: "comprehensive",
-    sources: ["academic", "industry", "news"]
-  }
-}
+In Claude Code, load this mode as a skill:
 ```
-
-### Option 2: Using NPX CLI (Fallback when MCP not available)
-```bash
-# Use when running from terminal or MCP tools unavailable
-npx monomind sparc run researcher "research AI trends 2024"
-
-# For alpha features
-npx monomind@alpha sparc run researcher "research AI trends 2024"
-```
-
-### Option 3: Local Installation
-```bash
-# If monomind is installed locally
-./monomind sparc run researcher "research AI trends 2024"
+Skill("sparc:researcher")
 ```
 
 ## Core Capabilities