agentic-qe 1.0.0

package/.claude/commands/automation/session-memory.md

@@ -0,0 +1,90 @@
+# Cross-Session Memory
+
+## Purpose
+Maintain context and learnings across Claude Code sessions for continuous improvement.
+
+## Memory Features
+
+### 1. Automatic State Persistence
+At session end, automatically saves:
+- Active agents and specializations
+- Task history and patterns
+- Performance metrics
+- Neural network weights
+- Knowledge base updates
+
+### 2. Session Restoration
+```javascript
+// Using MCP tools for memory operations
+mcp__claude-flow__memory_usage({
+  "action": "retrieve",
+  "key": "session-state",
+  "namespace": "sessions"
+})
+
+// Restore swarm state
+mcp__claude-flow__context_restore({
+  "snapshotId": "sess-123"
+})
+```
+
+**Fallback with npx:**
+```bash
+npx claude-flow hook session-restore --session-id "sess-123"
+```
+
+### 3. Memory Types
+
+**Project Memory:**
+- File relationships
+- Common edit patterns
+- Testing approaches
+- Build configurations
+
+**Agent Memory:**
+- Specialization levels
+- Task success rates
+- Optimization strategies
+- Error patterns
+
+**Performance Memory:**
+- Bottleneck history
+- Optimization results
+- Token usage patterns
+- Efficiency trends
+
+### 4. Privacy & Control
+```javascript
+// List memory contents
+mcp__claude-flow__memory_usage({
+  "action": "list",
+  "namespace": "sessions"
+})
+
+// Delete specific memory
+mcp__claude-flow__memory_usage({
+  "action": "delete",
+  "key": "session-123",
+  "namespace": "sessions"
+})
+
+// Backup memory
+mcp__claude-flow__memory_backup({
+  "path": "./backups/memory-backup.json"
+})
+```
+
+**Manual control:**
+```bash
+# View stored memory
+ls .claude-flow/memory/
+
+# Disable memory
+export CLAUDE_FLOW_MEMORY_PERSIST=false
+```
+
+## Benefits
+- 🧠 Contextual awareness
+- 📈 Cumulative learning
+- ⚡ Faster task completion
+- 🎯 Personalized optimization

package/.claude/commands/automation/smart-agents.md

@@ -0,0 +1,73 @@
+# Smart Agent Auto-Spawning
+
+## Purpose
+Automatically spawn the right agents at the right time without manual intervention.
+
+## Auto-Spawning Triggers
+
+### 1. File Type Detection
+When editing files, agents auto-spawn:
+- **JavaScript/TypeScript**: Coder agent
+- **Markdown**: Researcher agent
+- **JSON/YAML**: Analyst agent
+- **Multiple files**: Coordinator agent
+
+### 2. Task Complexity
+```
+Simple task: "Fix typo"
+→ Single coordinator agent
+
+Complex task: "Implement OAuth with Google"
+→ Architect + Coder + Tester + Researcher
+```
+
+### 3. Dynamic Scaling
+The system monitors workload and spawns additional agents when:
+- Task queue grows
+- Complexity increases
+- Parallel opportunities exist
+
+**Status Monitoring:**
+```javascript
+// Check swarm health
+mcp__claude-flow__swarm_status({
+  "swarmId": "current"
+})
+
+// Monitor agent performance
+mcp__claude-flow__agent_metrics({
+  "agentId": "agent-123"
+})
+```
+
+## Configuration
+
+### MCP Tool Integration
+Uses Claude Flow MCP tools for agent coordination:
+```javascript
+// Initialize swarm with appropriate topology
+mcp__claude-flow__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 8,
+  "strategy": "auto"
+})
+
+// Spawn agents based on file type
+mcp__claude-flow__agent_spawn({
+  "type": "coder",
+  "name": "JavaScript Handler",
+  "capabilities": ["javascript", "typescript"]
+})
+```
+
+### Fallback Configuration
+If MCP tools are unavailable:
+```bash
+npx claude-flow hook pre-task --auto-spawn-agents
+```
+
+## Benefits
+- 🤖 Zero manual agent management
+- 🎯 Perfect agent selection
+- 📈 Dynamic scaling
+- 💾 Resource efficiency

package/.claude/commands/automation/smart-spawn.md

@@ -0,0 +1,25 @@
+# smart-spawn
+
+Intelligently spawn agents based on workload analysis.
+
+## Usage
+```bash
+npx claude-flow automation smart-spawn [options]
+```
+
+## Options
+- `--analyze` - Analyze before spawning
+- `--threshold <n>` - Spawn threshold
+- `--topology <type>` - Preferred topology
+
+## Examples
+```bash
+# Smart spawn with analysis
+npx claude-flow automation smart-spawn --analyze
+
+# Set spawn threshold
+npx claude-flow automation smart-spawn --threshold 5
+
+# Force topology
+npx claude-flow automation smart-spawn --topology hierarchical
+```

package/.claude/commands/automation/workflow-select.md

@@ -0,0 +1,25 @@
+# workflow-select
+
+Automatically select optimal workflow based on task type.
+
+## Usage
+```bash
+npx claude-flow automation workflow-select [options]
+```
+
+## Options
+- `--task <description>` - Task description
+- `--constraints <list>` - Workflow constraints
+- `--preview` - Preview without executing
+
+## Examples
+```bash
+# Select workflow for task
+npx claude-flow automation workflow-select --task "Deploy to production"
+
+# With constraints
+npx claude-flow automation workflow-select --constraints "no-downtime,rollback"
+
+# Preview mode
+npx claude-flow automation workflow-select --task "Database migration" --preview
+```

package/.claude/commands/coordination/README.md

@@ -0,0 +1,9 @@
+# Coordination Commands
+
+Commands for coordination operations in Claude Flow.
+
+## Available Commands
+
+- [swarm-init](./swarm-init.md)
+- [agent-spawn](./agent-spawn.md)
+- [task-orchestrate](./task-orchestrate.md)

package/.claude/commands/coordination/agent-spawn.md

@@ -0,0 +1,25 @@
+# agent-spawn
+
+Spawn a new agent in the current swarm.
+
+## Usage
+```bash
+npx claude-flow agent spawn [options]
+```
+
+## Options
+- `--type <type>` - Agent type (coder, researcher, analyst, tester, coordinator)
+- `--name <name>` - Custom agent name
+- `--skills <list>` - Specific skills (comma-separated)
+
+## Examples
+```bash
+# Spawn coder agent
+npx claude-flow agent spawn --type coder
+
+# With custom name
+npx claude-flow agent spawn --type researcher --name "API Expert"
+
+# With specific skills
+npx claude-flow agent spawn --type coder --skills "python,fastapi,testing"
+```

package/.claude/commands/coordination/init.md

@@ -0,0 +1,44 @@
+# Initialize Coordination Framework
+
+## 🎯 Key Principle
+**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
+
+## MCP Tool Usage in Claude Code
+
+**Tool:** `mcp__claude-flow__swarm_init`
+
+## Parameters
+```json
+{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}
+```
+
+## Description
+Set up a coordination topology to guide Claude Code's approach to complex tasks
+
+## Details
+This tool creates a coordination framework that helps Claude Code:
+- Break down complex problems systematically
+- Approach tasks from multiple perspectives
+- Maintain consistency across large projects
+- Work more efficiently through structured coordination
+
+Remember: This does NOT create actual coding agents. It creates a coordination pattern for Claude Code to follow.
+
+## Example Usage
+
+**In Claude Code:**
+1. Use the tool: `mcp__claude-flow__swarm_init`
+2. With parameters: `{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}`
+3. Claude Code then executes the coordinated plan using its native tools
+
+## Important Reminders
+- ✅ This tool provides coordination and structure
+- ✅ Claude Code performs all actual implementation
+- ❌ The tool does NOT write code
+- ❌ The tool does NOT access files directly
+- ❌ The tool does NOT execute commands
+
+## See Also
+- Main documentation: /claude.md
+- Other commands in this category
+- Workflow examples in /workflows/

package/.claude/commands/coordination/orchestrate.md

@@ -0,0 +1,43 @@
+# Coordinate Task Execution
+
+## 🎯 Key Principle
+**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
+
+## MCP Tool Usage in Claude Code
+
+**Tool:** `mcp__claude-flow__task_orchestrate`
+
+## Parameters
+```json
+{"task": "Implement authentication system", "strategy": "parallel", "priority": "high"}
+```
+
+## Description
+Break down and coordinate complex tasks for systematic execution by Claude Code
+
+## Details
+Orchestration strategies:
+- **parallel**: Claude Code works on independent components simultaneously
+- **sequential**: Step-by-step execution for dependent tasks
+- **adaptive**: Dynamically adjusts based on task complexity
+
+The orchestrator creates a plan that Claude Code follows using its native tools.
+
+## Example Usage
+
+**In Claude Code:**
+1. Use the tool: `mcp__claude-flow__task_orchestrate`
+2. With parameters: `{"task": "Implement authentication system", "strategy": "parallel", "priority": "high"}`
+3. Claude Code then executes the coordinated plan using its native tools
+
+## Important Reminders
+- ✅ This tool provides coordination and structure
+- ✅ Claude Code performs all actual implementation
+- ❌ The tool does NOT write code
+- ❌ The tool does NOT access files directly
+- ❌ The tool does NOT execute commands
+
+## See Also
+- Main documentation: /claude.md
+- Other commands in this category
+- Workflow examples in /workflows/

package/.claude/commands/coordination/spawn.md

@@ -0,0 +1,45 @@
+# Create Cognitive Patterns
+
+## 🎯 Key Principle
+**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
+
+## MCP Tool Usage in Claude Code
+
+**Tool:** `mcp__claude-flow__agent_spawn`
+
+## Parameters
+```json
+{"type": "researcher", "name": "Literature Analysis", "capabilities": ["deep-analysis"]}
+```
+
+## Description
+Define cognitive patterns that represent different approaches Claude Code can take
+
+## Details
+Agent types represent thinking patterns, not actual coders:
+- **researcher**: Systematic exploration approach
+- **coder**: Implementation-focused thinking
+- **analyst**: Data-driven decision making
+- **architect**: Big-picture system design
+- **reviewer**: Quality and consistency checking
+
+These patterns guide how Claude Code approaches different aspects of your task.
+
+## Example Usage
+
+**In Claude Code:**
+1. Use the tool: `mcp__claude-flow__agent_spawn`
+2. With parameters: `{"type": "researcher", "name": "Literature Analysis", "capabilities": ["deep-analysis"]}`
+3. Claude Code then executes the coordinated plan using its native tools
+
+## Important Reminders
+- ✅ This tool provides coordination and structure
+- ✅ Claude Code performs all actual implementation
+- ❌ The tool does NOT write code
+- ❌ The tool does NOT access files directly
+- ❌ The tool does NOT execute commands
+
+## See Also
+- Main documentation: /claude.md
+- Other commands in this category
+- Workflow examples in /workflows/

package/.claude/commands/coordination/swarm-init.md

@@ -0,0 +1,85 @@
+# swarm init
+
+Initialize a Claude Flow swarm with specified topology and configuration.
+
+## Usage
+
+```bash
+npx claude-flow swarm init [options]
+```
+
+## Options
+
+- `--topology, -t <type>` - Swarm topology: mesh, hierarchical, ring, star (default: hierarchical)
+- `--max-agents, -m <number>` - Maximum number of agents (default: 8)
+- `--strategy, -s <type>` - Execution strategy: balanced, parallel, sequential (default: parallel)
+- `--auto-spawn` - Automatically spawn agents based on task complexity
+- `--memory` - Enable cross-session memory persistence
+- `--github` - Enable GitHub integration features
+
+## Examples
+
+### Basic initialization
+
+```bash
+npx claude-flow swarm init
+```
+
+### Mesh topology for research
+
+```bash
+npx claude-flow swarm init --topology mesh --max-agents 5 --strategy balanced
+```
+
+### Hierarchical for development
+
+```bash
+npx claude-flow swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
+```
+
+### GitHub-focused swarm
+
+```bash
+npx claude-flow swarm init --topology star --github --memory
+```
+
+## Topologies
+
+### Mesh
+
+- All agents connect to all others
+- Best for: Research, exploration, brainstorming
+- Communication: High overhead, maximum information sharing
+
+### Hierarchical
+
+- Tree structure with clear command chain
+- Best for: Development, structured tasks, large projects
+- Communication: Efficient, clear responsibilities
+
+### Ring
+
+- Agents connect in a circle
+- Best for: Pipeline processing, sequential workflows
+- Communication: Low overhead, ordered processing
+
+### Star
+
+- Central coordinator with satellite agents
+- Best for: Simple tasks, centralized control
+- Communication: Minimal overhead, clear coordination
+
+## Integration with Claude Code
+
+Once initialized, use MCP tools in Claude Code:
+
+```javascript
+mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 8 }
+```
+
+## See Also
+
+- `agent spawn` - Create swarm agents
+- `task orchestrate` - Coordinate task execution
+- `swarm status` - Check swarm state
+- `swarm monitor` - Real-time monitoring

package/.claude/commands/coordination/task-orchestrate.md

@@ -0,0 +1,25 @@
+# task-orchestrate
+
+Orchestrate complex tasks across the swarm.
+
+## Usage
+```bash
+npx claude-flow task orchestrate [options]
+```
+
+## Options
+- `--task <description>` - Task description
+- `--strategy <type>` - Orchestration strategy
+- `--priority <level>` - Task priority (low, medium, high, critical)
+
+## Examples
+```bash
+# Orchestrate development task
+npx claude-flow task orchestrate --task "Implement user authentication"
+
+# High priority task
+npx claude-flow task orchestrate --task "Fix production bug" --priority critical
+
+# With specific strategy
+npx claude-flow task orchestrate --task "Refactor codebase" --strategy parallel
+```

package/.claude/commands/flow-nexus/app-store.md

@@ -0,0 +1,124 @@
+---
+name: flow-nexus-app-store
+description: Browse, publish, and deploy applications
+---
+
+# Flow Nexus App Store
+
+Browse templates, publish apps, and deploy solutions.
+
+## Browse Apps
+```javascript
+// Search apps
+mcp__flow-nexus__app_search({
+  search: "authentication",
+  category: "backend",
+  featured: true,
+  limit: 20
+})
+
+// Get app details
+mcp__flow-nexus__app_get({ app_id: "app_id" })
+
+// List templates
+mcp__flow-nexus__app_store_list_templates({
+  category: "web-api",
+  tags: ["express", "jwt"],
+  limit: 20
+})
+```
+
+## Publish App
+```javascript
+mcp__flow-nexus__app_store_publish_app({
+  name: "My Auth Service",
+  description: "JWT-based authentication microservice",
+  category: "backend",
+  version: "1.0.0",
+  source_code: sourceCode,
+  tags: ["auth", "jwt", "express"],
+  metadata: {
+    author: "Your Name",
+    license: "MIT",
+    repository: "github.com/user/repo"
+  }
+})
+```
+
+## Deploy Templates
+```javascript
+// Get template details
+mcp__flow-nexus__template_get({
+  template_name: "express-api-starter"
+})
+
+// Deploy template
+mcp__flow-nexus__template_deploy({
+  template_name: "express-api-starter",
+  deployment_name: "my-api",
+  variables: {
+    api_key: "your_key",
+    database_url: "postgres://..."
+  },
+  env_vars: {
+    NODE_ENV: "production"
+  }
+})
+```
+
+## Analytics
+```javascript
+// Get app analytics
+mcp__flow-nexus__app_analytics({
+  app_id: "your_app_id",
+  timeframe: "30d" // 24h, 7d, 30d, 90d
+})
+
+// View installed apps
+mcp__flow-nexus__app_installed({
+  user_id: "your_id"
+})
+```
+
+## Update App
+```javascript
+mcp__flow-nexus__app_update({
+  app_id: "app_id",
+  updates: {
+    version: "1.1.0",
+    description: "Updated description",
+    tags: ["new", "tags"]
+  }
+})
+```
+
+## Market Data
+```javascript
+// Get market statistics
+mcp__flow-nexus__market_data()
+```
+
+## Template Categories
+- **web-api**: RESTful APIs and microservices
+- **frontend**: React, Vue, Angular apps
+- **full-stack**: Complete applications
+- **cli-tools**: Command-line utilities
+- **data-processing**: ETL and analytics
+- **ml-models**: Pre-trained models
+- **blockchain**: Web3 applications
+- **mobile**: React Native apps
+
+## Publishing Best Practices
+1. Include comprehensive documentation
+2. Add example usage and configuration
+3. Include tests and CI/CD setup
+4. Use semantic versioning
+5. Add clear license information
+6. Include docker/deployment configs
+7. Provide migration guides for updates
+
+## Revenue Sharing
+- Earn rUv credits when others use your templates
+- Set pricing (0 for free templates)
+- Track usage and earnings in analytics
+- Withdraw credits or use for Flow Nexus services