claude-flow-novice 1.0.0

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

package/.claude/commands/flow-nexus/challenges.md

@@ -0,0 +1,120 @@
+---
+name: flow-nexus-challenges
+description: Coding challenges, achievements, and leaderboards
+---
+
+# Flow Nexus Challenges
+
+Complete coding challenges to earn rUv credits and climb the leaderboard.
+
+## List Challenges
+```javascript
+mcp__flow-nexus__challenges_list({
+  difficulty: "intermediate", // beginner, advanced, expert
+  category: "algorithms",
+  status: "active",
+  limit: 20
+})
+```
+
+## Get Challenge Details
+```javascript
+mcp__flow-nexus__challenge_get({
+  challenge_id: "two-sum-problem"
+})
+```
+
+## Submit Solution
+```javascript
+mcp__flow-nexus__challenge_submit({
+  challenge_id: "challenge_id",
+  user_id: "your_id",
+  solution_code: `
+    function solution(nums, target) {
+      const map = new Map();
+      for (let i = 0; i < nums.length; i++) {
+        const complement = target - nums[i];
+        if (map.has(complement)) {
+          return [map.get(complement), i];
+        }
+        map.set(nums[i], i);
+      }
+      return [];
+    }
+  `,
+  language: "javascript",
+  execution_time: 45 // milliseconds
+})
+```
+
+## Complete Challenge
+```javascript
+mcp__flow-nexus__app_store_complete_challenge({
+  challenge_id: "challenge_id",
+  user_id: "your_id",
+  submission_data: {
+    passed_tests: 10,
+    total_tests: 10,
+    execution_time: 45
+  }
+})
+```
+
+## Leaderboards
+```javascript
+// Global leaderboard
+mcp__flow-nexus__leaderboard_get({
+  type: "global", // weekly, monthly, challenge
+  limit: 10
+})
+
+// Challenge-specific leaderboard
+mcp__flow-nexus__leaderboard_get({
+  type: "challenge",
+  challenge_id: "specific_challenge",
+  limit: 25
+})
+```
+
+## Achievements
+```javascript
+mcp__flow-nexus__achievements_list({
+  user_id: "your_id",
+  category: "speed_demon" // Categories vary
+})
+```
+
+## rUv Credits
+```javascript
+// Check balance
+mcp__flow-nexus__ruv_balance({ user_id: "your_id" })
+
+// View history
+mcp__flow-nexus__ruv_history({
+  user_id: "your_id",
+  limit: 20
+})
+
+// Earn credits (automatic on completion)
+mcp__flow-nexus__app_store_earn_ruv({
+  user_id: "your_id",
+  amount: 100,
+  reason: "Completed expert challenge",
+  source: "challenge"
+})
+```
+
+## Challenge Categories
+- **algorithms**: Classic algorithm problems
+- **data-structures**: DS implementation challenges
+- **system-design**: Architecture challenges
+- **optimization**: Performance challenges
+- **security**: Security-focused problems
+- **ml-basics**: Machine learning fundamentals
+
+## Tips
+1. Start with beginner challenges
+2. Review other solutions after completing
+3. Optimize for both correctness and speed
+4. Complete daily challenges for bonus credits
+5. Unlock achievements for extra rewards