masharratt-claude-flow-novice-2

Claude Flow Novice v2.18.1 Documentation

Version: 2.18.1 (RuVector Integration) Last Updated: 2025-12-05

Package Metrics:

• Namespace-isolated installation (~0.01% collision risk)
• Semantic codebase search via RuVector
• Multi-provider routing (Z.ai, Kimi, OpenRouter, Anthropic)

Overview

AI agent orchestration with semantic codebase search, Redis coordination, and multi-loop consensus validation (CFN Loop).

CFN Loop Execution Modes

Task Mode (Debugging - Full Visibility)

• Spawn Method: Main Chat spawns Task() agents directly
• Cost: $0.150/iteration (Anthropic provider)
• Visibility: Complete agent output in Main Chat
• Use Case: Debugging, learning, short tasks (<5 minutes)
• Memory: ANTI-023 protection prevents memory leaks
• Audit: Automatic audit trail storage in SQLite and Redis

CLI Mode (Production - Cost Optimized)

• Spawn Method: Coordinator spawns CLI agents via npx claude-flow-novice
• Cost: $0.054/iteration (64% savings vs Task mode)
• Visibility: Background execution with progress tracking
• Use Case: Production, long tasks, cost-sensitive workflows
• Memory: Redis-based coordination with recovery capabilities
• Custom Routing: Optional 5x cost reduction with Z.ai provider
• Redis Configuration: Requires CFN_REDIS_HOST=localhost for non-Docker environments (see CLI Mode Redis Configuration)

Mode Selection Guide

• Use Task Mode when: Debugging issues, learning CFN Loop, short tasks requiring full visibility
• Use CLI Mode when: Production work, cost optimization, long-running tasks, background execution
• Custom Routing: /custom-routing-activate for 95-98% total cost savings when using CLI mode

Slash Commands

• /cfn-loop-task: Task mode execution (Main Chat → Task() agents)
• /cfn-loop-cli: CLI mode execution (Main Chat → coordinator → CLI agents)
• Mode Parameters: --mode=mvp|standard|enterprise with different confidence thresholds

Cost Comparison

• Task Mode: $0.150/iteration (full visibility, debugging)
• CLI Mode: $0.054/iteration (64% savings, production)
• With Custom Routing: $0.004-0.010/iteration (95-98% total savings)

Quick Start

Task Mode (Debugging - Full Visibility)

# Install and initialize
npm install claude-flow-novice
npx cfn-init

# Execute CFN Loop - Main Chat spawns Task() agents directly
/cfn-loop-task "Implement JWT authentication" --mode=standard

# Custom routing available for 5x cost reduction
/custom-routing-activate

CLI Mode (Production - Cost Optimized)

# Install and initialize
npm install claude-flow-novice
npx cfn-init

# Configure Redis for non-Docker environments
export CFN_REDIS_HOST=localhost
export CFN_REDIS_PORT=6379

# Execute CFN Loop - Coordinator spawns CLI agents in background
/cfn-loop-cli "Implement JWT authentication" --mode=standard

# Initialize swarm with skills
npx claude-flow-novice swarm "Task Description" \
  --skills=redis-coordination,agent-spawning \
  --strategy development

Documentation Index

Core Concepts

• Skills System - Modular, reusable agent capabilities
• CFN Loop - Three-loop consensus validation framework
• RuVector Search - Semantic codebase indexing
• Redis Coordination - Zero-token agent coordination

User Guides

• Slash Commands - CLI command reference
• Hooks System - Event-driven automation
• Post-Edit Pipeline - Automatic validation after edits

Technical Reference

• API Documentation - JavaScript/TypeScript API
• Features Matrix - Feature availability by mode
• Functions Reference - Core function library

Workflows

• CFN Loop Flow - Visual workflow diagrams
• CFN Loop Cheatsheet - Quick reference guide

Maintenance

• Changelog - Version history and breaking changes
• Decision Log - Architecture decision records
• Component Status - Dependency health

Legacy

• Deprecated MCP Logs - Historical MCP implementation
• v1 Documentation - Previous documentation version

Key Features (v2.18.1)

RuVector Codebase Search (NEW)

• Semantic Search: Natural language queries against codebase
• OpenAI Embeddings: text-embedding-3-small (1536 dimensions)
• Manifest System: .cfn-manifest.json tracks CFN vs custom files
• Safe Distribution: Custom files preserved during CFN updates