claude-flow-novice 2.15.2 → 2.15.4

package/README.md.backup_before_replace

@@ -1,781 +0,0 @@
-# Claude Flow Novice v3 - AI Agent Orchestration Framework
-
-[![npm version](https://badge.fury.io/js/claude-flow-novice.svg)](https://badge.fury.io/js/claude-flow-novice)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
-
-A production-ready AI agent orchestration system with autonomous self-correcting workflows, multi-domain support, and intelligent learning capabilities. Built for developers who need reliable, cost-effective agent coordination.
-
-## 🚀 Quick Start
-
-```bash
-# 1. Install package (automatically initializes CFN files)
-npm install claude-flow-novice
-
-# 2. Activate CFN instructions for CLI agents
-cp CFN-CLAUDE.md CLAUDE.md
-
-# 3. Execute CFN Loop for complex features
-npx cfn-loop "Implement JWT authentication system" --mode=standard
-
-# Or spawn agents directly
-npx cfn-spawn backend-dev --task-id auth-task
-```
-
-**What happens on install**:
-- Copies 23 agents to `.claude/agents/cfn-dev-team/`
-- Copies 43 skills to `.claude/skills/cfn-*/`
-- Copies 7 hooks to `.claude/hooks/cfn-*`
-- Copies 45+ commands to `.claude/commands/cfn/`
-- Copies `CFN-CLAUDE.md` reference file
-
-**Important**: CLI-spawned agents read instructions from `CLAUDE.md` in your project root. Copy `CFN-CLAUDE.md` → `CLAUDE.md` to activate CFN workflows.
-
-## ✨ What Makes CFN v3 Different
-
-**Self-Correcting Workflows** - Automatic iteration until quality gates met (≥0.75 confidence, ≥0.90 consensus)
-
-**95-98% Cost Savings** - CLI mode with Z.ai routing ($0.50/1M vs $3-15/1M tokens)
-
-**Learns Over Time** - Playbook system reduces iterations by 30-40% after 10 similar tasks
-
-**Multi-Domain** - Supports 6 task types with domain-specific validation
-
-**Zero-Token Coordination** - Redis BLPOP for infinite waiting without API costs
-
----
-
-## 🎯 Core CFN Loop System
-
-### CFN Loop Architecture
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                       CFN Loop v3 Flow                          │
-└─────────────────────────────────────────────────────────────────┘
-
-User Task Description
-    ↓
-┌───────────────────────────────────────┐
-│ cfn-v3-coordinator                    │
-│ • Classify task type                  │
-│ • Query playbook for similar tasks    │
-│ • Select Loop 3 + Loop 2 agents       │
-│ • Load validation templates           │
-│ • Estimate complexity & iterations    │
-└───────────────┬───────────────────────┘
-                ↓
-┌───────────────────────────────────────┐
-│ CFN Loop Orchestrator                 │
-│ (orchestrate.sh)                      │
-└───────────────┬───────────────────────┘
-                ↓
-┌───────────────────────────────────────────────────────────┐
-│ ITERATION N                                               │
-├───────────────────────────────────────────────────────────┤
-│                                                           │
-│  ┌─────────────────────────────────────────────┐        │
-│  │ Loop 3: Implementation (parallel agents)    │        │
-│  │ • backend-dev, coder, devops-engineer, etc  │        │
-│  │ • Each reports confidence score (0.0-1.0)   │        │
-│  └─────────────────┬───────────────────────────┘        │
-│                    ↓                                      │
-│  ┌─────────────────────────────────────────────┐        │
-│  │ Gate Check: Self-Validation                 │        │
-│  │ • Check Loop 3 confidence ≥ threshold       │        │
-│  │ • MVP: 0.70 | Standard: 0.75 | Enterprise: 0.85 │   │
-│  └─────────────────┬───────────────────────────┘        │
-│                    ↓                                      │
-│         ┌──────────┴──────────┐                         │
-│         │ Gate PASS?          │                         │
-│         └──┬────────────────┬─┘                         │
-│           NO                YES                          │
-│            ↓                 ↓                           │
-│    ┌───────────┐    ┌───────────────────────────┐     │
-│    │ ITERATE   │    │ Deliverable Verification  │     │
-│    │ N+1       │    │ • git diff for file changes│     │
-│    │ (retry)   │    │ • Force ITERATE if no files│     │
-│    └───────────┘    └──────────┬────────────────┘     │
-│                                  ↓                       │
-│                    ┌─────────────────────────────────┐ │
-│                    │ Loop 2: Validation (parallel)   │ │
-│                    │ • reviewer, tester, security    │ │
-│                    │ • Each reports consensus score  │ │
-│                    └──────────┬──────────────────────┘ │
-│                                ↓                        │
-│                    ┌─────────────────────────────────┐ │
-│                    │ Consensus Check                 │ │
-│                    │ • Aggregate validator scores    │ │
-│                    │ • MVP: 0.80 | Std: 0.90 | Ent: 0.95 │ │
-│                    └──────────┬──────────────────────┘ │
-│                                ↓                        │
-│                    ┌─────────────────────────────────┐ │
-│                    │ Loop 4: Product Owner Decision  │ │
-│                    │ • PROCEED: Accept deliverables  │ │
-│                    │ • ITERATE: Retry with feedback  │ │
-│                    │ • ABORT: Stop execution         │ │
-│                    └──────────┬──────────────────────┘ │
-│                                ↓                        │
-│                     ┌──────────┴─────────┐            │
-│                     │ Decision?           │            │
-│                     └──┬──────────────┬──┘            │
-│                       ITERATE        PROCEED           │
-│                        ↓                ↓              │
-└────────────────────────┼────────────────┼──────────────┘
-                         │                │
-                 ┌───────┘                └────────┐
-                 ↓                                  ↓
-          (Next Iteration)                  ┌──────────────┐
-          Max iterations:                   │ Loop 5:      │
-          • MVP: 5                          │ Retrospective│
-          • Standard: 10                    │ • Extract    │
-          • Enterprise: 15                  │   patterns   │
-                                            │ • Update     │
-                                            │   playbook   │
-                                            │ • Rank agents│
-                                            └──────────────┘
-```
-
-### Self-Correcting Multi-Loop Validation
-
-**Gate Validation** - Implementation confidence scores
-- MVP: ≥0.70 | Standard: ≥0.75 | Enterprise: ≥0.85
-
-**Consensus Validation** - Validator agreement
-- MVP: ≥0.80 | Standard: ≥0.90 | Enterprise: ≥0.95
-
-**Automatic Iteration** - Self-correcting loops with max iterations:
-- MVP: 5 | Standard: 10 | Enterprise: 15
-
-### Dual-Mode Execution
-
-**CLI Mode (Default)** - Production cost optimization
-- 95-98% cost reduction via Z.ai routing
-- Redis context storage for swarm recovery
-- Zero-token waiting (BLPOP)
-- Scalable to 10+ agents
-
-**Task Mode** - Development & debugging
-- Full visibility in Main Chat
-- Direct context injection
-- Anthropic routing
-- Easier troubleshooting
-
-```bash
-# CLI mode (default)
-/cfn-loop "Task description" --mode=standard
-
-# Task mode (debugging)
-/cfn-loop "Task description" --spawn-mode=task
-```
-
----
-
-## 🧠 AI-Driven Intelligence (43 Modular Skills)
-
-### Phase 1: Foundation (5 Skills)
-
-| Skill | Purpose | Impact |
-|-------|---------|--------|
-| `task-classifier` | Detect domain (software/content/research/design/infrastructure/data) | Automatic agent selection |
-| `validation-templates` | Domain-specific quality criteria | Relevant validation gates |
-| `agent-selector` | Dynamic agent recommendation | Optimal team composition |
-| `context-pruner` | Summarize large contexts | 88% size reduction |
-| `cfn-v3-coordinator` | Task analysis → JSON config | Intelligent orchestration |
-
-### Phase 2: Learning System (2 Skills)
-
-| Skill | Purpose | Impact |
-|-------|---------|--------|
-| `playbook` | SQLite pattern storage with similarity matching | 30-40% iteration reduction |
-| `complexity-estimator` | Predict iterations from task analysis | Accurate effort estimates |
-
-### Phase 3: Epic Decomposition (4 Skills)
-
-| Skill | Purpose | Impact |
-|-------|---------|--------|
-| `epic-decomposer` | Break epics into focused sprints | Manageable scope |
-| `sprint-planner` | Define scope boundaries (in/out/deliverables) | Prevents over-implementation |
-| `dependency-extractor` | Topological sorting for sprint order | Correct sequencing |
-| `sprint-execution` | Sprint-aware agent execution | Focused context injection |
-
-### Phase 4: Real-Time Intervention (5 Skills)
-
-| Skill | Purpose | Triggers |
-|-------|---------|----------|
-| `intervention-detector` | Identify stuck loops | Plateau (Δ<0.05), recurring feedback, no deliverables |
-| `agent-swap` | Replace underperforming agents | Repeated failures on same task |
-| `specialist-injection` | Add domain experts mid-loop | Security issues, performance bottlenecks |
-| `scope-simplifier` | Reduce deliverables | Complexity exceeds capacity |
-| `intervention-orchestrator` | Coordinate adaptive corrections | Any intervention trigger |
-
-### Phase 5: Continuous Learning (4 Skills)
-
-| Skill | Purpose | Output |
-|-------|---------|--------|
-| `pattern-extraction` | Identify bottlenecks from execution logs | Pattern insights |
-| `playbook-auto-update` | Store successful strategies | Persistent learning |
-| `improvement-recommender` | Rank agent performance | Optimization suggestions |
-| `retrospective-report` | Generate human-readable analysis | Sprint retrospectives |
-
-### Core Infrastructure (23 Skills)
-
-- **Coordination**: `redis-coordination`, `agent-spawning`, `cfn-loop-orchestration`
-- **Validation**: `cfn-loop-validation`, `product-owner-decision`, `loop2-output-processing`, `loop3-output-processing`
-- **Agent Processing**: `agent-output-processing`, `agent-discovery`, `agent-selector`
-- **Utilities**: `hook-pipeline`, `hybrid-routing`, `sqlite-memory`, `transparency-middleware`
-- **Plus 9 more**: Process lifecycle, config management, test execution, etc.
-
----
-
-## 🤖 Agent Library
-
-### CFN v3 Coordinators (3)
-
-- `cfn-v3-coordinator` - Main CFN Loop analyzer and configuration generator
-- `multi-sprint-coordinator` - Epic-level orchestration across sprints
-- `retrospective-analyst` - Automatic learning and pattern extraction
-
-### Core Development Agents
-
-**Implementation**
-- `coder` - General-purpose code implementation
-- `backend-dev` - Backend services and APIs
-- `frontend-dev` - Frontend applications
-- `mobile-dev` - React Native and cross-platform
-- `rust-developer` - Rust language specialist
-
-**Quality Assurance**
-- `reviewer` - Code review and quality validation
-- `tester` - Test writing and execution
-- `security-specialist` - Security analysis and hardening
-- `architect` - System design and architecture
-
-**Infrastructure**
-- `devops-engineer` - DevOps and deployment
-- `database-engineer` - Database design and optimization
-- `api-designer` - API architecture and REST design
-
-### Domain Specialists
-
-**Software Development**
-- `code-analyzer`, `performance-benchmarker`, `accessibility-advocate`
-- `security-auditor`, `compliance-checker`, `cost-optimizer`
-
-**Infrastructure & DevOps**
-- `terraform-engineer`, `kubernetes-architect`
-
-**Data Engineering**
-- `data-engineer`, `pipeline-builder`, `etl-specialist`
-
-**Content Creation**
-- `copywriter`, `content-strategist`, `seo-specialist`
-
-**Design & UX**
-- `ui-designer`, `ux-researcher`, `visual-designer`
-
----
-
-## 🚀 CLI & Slash Commands
-
-### CFN Loop Commands (8)
-
-```bash
-# Single task execution
-/cfn-loop "Implement JWT authentication" --mode=standard
-
-# Quick single-iteration task
-/cfn-loop-single "Fix security bug in auth module"
-
-# Large multi-phase epic
-/cfn-loop-epic "Build complete authentication system"
-
-# Phase with multiple sprints
-/cfn-loop-sprints "Implement payment processing"
-
-# Documentation generation
-/cfn-loop-document --sprint=auth --epic=user-mgmt
-
-# Rule synchronization
-/cfn-claude-sync --dry-run
-
-# Agent optimization
-/cfn-optimize-agents --parallel=3
-
-# Toggle spawning mode
-/cfn-mode # Switch between CLI and Task spawning
-```
-
-### Binary Commands (7)
-
-```bash
-cfn-spawn          # Spawn individual agents
-cfn-loop           # Execute CFN Loop workflow
-cfn-swarm          # Multi-agent coordination
-cfn-portal         # Web monitoring dashboard
-cfn-context        # Context management
-cfn-metrics        # Performance tracking
-cfn-redis          # Redis coordination utilities
-```
-
----
-
-## 🔄 Redis Coordination
-
-### Zero-Token Waiting Mode
-
-**BLPOP-Based Blocking** - Infinite wait, zero API cost
-- Agents block with `redis-cli blpop "queue" 0`
-- Coordinator wakes agents with `redis-cli lpush "queue" "signal"`
-- <100ms latency wake-up
-- Context preserved across iterations
-
-**Swarm Recovery** - Redis persistence enables crash recovery
-- Task context stored in Redis with TTL
-- Agents resume from last known state
-- Critical for long-running CFN Loops
-
-### Coordination Patterns
-
-| Pattern | Use Case | Agent Count |
-|---------|----------|-------------|
-| **Simple Chain** | Sequential dependencies | 2-3 |
-| **Hierarchical Broadcast** | Coordinator → Workers | 4-10 |
-| **Mesh Hybrid** | Complex collaboration | 5-15 |
-
----
-
-## 📊 Multi-Domain Support (6 Task Types)
-
-### 1. Software Development
-**Agents**: backend-dev, coder, devops-engineer, security-specialist
-**Validation**: Tests pass, security scan clean, build succeeds, coverage ≥80%
-**Deliverables**: Source files, test files, docs
-
-### 2. Content Creation
-**Agents**: copywriter, content-strategist, seo-specialist
-**Validation**: Grammar check, brand consistency, SEO score
-**Deliverables**: Articles, blog posts, marketing copy
-
-### 3. Research & Analysis
-**Agents**: researcher, data-analyst, domain-expert
-**Validation**: Fact-checking, methodology review, statistical significance
-**Deliverables**: Research reports, data insights
-
-### 4. Design & UX
-**Agents**: ui-designer, ux-researcher, visual-designer
-**Validation**: Accessibility compliance, user testing, brand guidelines
-**Deliverables**: Mockups, wireframes, prototypes
-
-### 5. Infrastructure & DevOps
-**Agents**: terraform-engineer, kubernetes-architect, devops-engineer
-**Validation**: Security audit, cost optimization, compliance
-**Deliverables**: IaC files, deployment configs
-
-### 6. Data Engineering
-**Agents**: data-engineer, pipeline-builder, etl-specialist
-**Validation**: Data quality, schema validation, performance testing
-**Deliverables**: Pipelines, transformations, data models
-
----
-
-## 📈 Performance & Cost Optimization
-
-### Cost Savings
-
-| Feature | Savings | Mechanism |
-|---------|---------|-----------|
-| **CLI Mode** | 95-98% | Z.ai routing ($0.50/1M vs Anthropic $3-15/1M) |
-| **Zero-Token Coordination** | 100% during waits | BLPOP blocking costs nothing |
-| **Context Pruning** | 88% tokens | Summarization at iteration 10 |
-| **Playbook Learning** | 30-40% iterations | Pattern reuse after 10 tasks |
-
-### Performance Metrics (vs v2)
-
-| Metric | v2 Baseline | v3 Actual | Improvement |
-|--------|-------------|-----------|-------------|
-| Average Iterations | 5.2 | 3.5-4.0 | ↓ 33% |
-| Context Size (iter 10) | 120 KB | 15-20 KB | ↓ 88% |
-| Time to Converge | 45 min | 30-35 min | ↓ 33% |
-| Playbook Hit Rate | 0% | 60%+ | N/A |
-
----
-
-## 🛠️ Developer Experience
-
-### Skills-Based Architecture
-
-**43 Total Skills** (20 CFN v3 + 23 core)
-- Modular and independently testable
-- Clear interfaces and contracts
-- Comprehensive documentation
-- Easy to extend
-
-### Hooks & Automation (39 Validation Hooks)
-
-```bash
-# Automatic post-edit validation
-./.claude/hooks/invoke-post-edit.sh "$FILE" --agent-id "$AGENT_ID"
-
-# Pre-commit security scanning
-# Test coverage enforcement
-# Hook pipeline orchestration
-```
-
-### Complexity Analysis Tools
-
-**Built-in Code Quality Monitoring**
-
-**Simple Complexity Analyzer** (~23ms)
-- Fast bash script analyzer
-- Counts decision points (if/loops/case)
-- Ratings: Simple (<10) → Very Complex (≥40)
-
-**Per-Function Analyzer**
-- Function-level complexity breakdown
-- Identifies specific refactor targets
-- Detailed reporting per method
-
-**Lizard (Professional Multi-Language)**
-- Auto-installed during npm install
-- Supports 20+ languages (JS/TS/Python/Java/Go/etc)
-- Industry-standard McCabe complexity metrics
-
-**Automated Monitoring**
-- Triggers on files >200 lines during post-edit
-- Warning at complexity 30-39
-- Critical at complexity ≥40 (auto-spawns refactor agent)
-
-```bash
-# Quick analysis
-./tools/simple-complexity.sh script.sh
-
-# Function-level breakdown
-./tools/calculate-complexity.sh script.sh
-
-# Multi-language professional analysis
-lizard src/module.ts --CCN 30
-```
-
-**See:** `readme/logs-tools.md` for complete documentation
-
-### Templates & Patterns
-
-- Agent creation templates (simple, standard, advanced)
-- Coordination patterns (Redis pub/sub)
-- Memory operations (SQLite ACL)
-- CFN Loop mechanics
-
----
-
-## 🔒 Security & Quality
-
-### Built-in Security
-
-**ACL System** - 5 levels of access control
-1. Private - Agent's own data only
-2. Swarm - Shared across team of agents
-3. Project - Strategic decisions, audit logs
-4. Strategic - Cross-project patterns
-5. System - Infrastructure only
-
-**Security Features**
-- Secret detection and prevention
-- Path traversal protection
-- Input sanitization
-- Envelope encryption for sensitive data
-
-### Quality Gates
-
-- **Deliverable Verification** - Prevents "consensus on vapor" (validators approving plans without code)
-- **Multi-Layer Context Injection** - Validation at coordinator → orchestrator → agent layers
-- **Agent Completion Protocol** - Mandatory confidence reporting
-- **Mandatory Iteration** - Forced retry if zero files created
-
-### Audit & Monitoring
-
-- Real-time violations monitoring
-- CFN Loop protocol enforcement
-- Agent lifecycle tracking
-- Performance benchmarking
-
----
-
-## 📦 What's Included in npm Package
-
-```
-dist/                          # Compiled TypeScript (SWC)
-.claude/
-├── agents/                    # 81 specialized agents
-│   ├── coordinators/          # 3 CFN v3 coordinators
-│   ├── developers/            # Implementation agents
-│   ├── reviewers/             # Quality assurance agents
-│   ├── testers/               # Testing agents
-│   └── security/              # Security specialists
-├── commands/                  # 8 CFN Loop slash commands
-├── skills/                    # 43 modular skills
-│   ├── cfn-loop-orchestration/
-│   ├── task-classifier/
-│   ├── playbook/
-│   ├── epic-decomposer/
-│   ├── intervention-detector/
-│   └── [38+ more skills]
-├── templates/                 # Agent creation templates
-└── *.md                       # CLAUDE.md, ACE system docs
-scripts/
-├── *.sh                       # Utility scripts
-└── *.js                       # Automation scripts
-docs/
-├── CFN_*.md                   # CFN Loop documentation
-├── planning/cfn-v3/           # Architecture docs (31 files)
-│   ├── IMPLEMENTATION_COMPLETE.md
-│   ├── DUAL_MODE_IMPLEMENTATION.md
-│   ├── V2_MODULARIZATION_ARCHITECTURE.md
-│   └── [28+ more docs]
-└── guides/                    # Implementation guides
-config/
-└── hooks/                     # 39 validation hooks
-```
-
-### Documentation (60+ Files)
-
-- **Architecture**: CFN v3 complete architecture, modularization docs
-- **Guides**: Redis coordination, validator implementation, epic decomposition
-- **Phase Reports**: 5 phase completion reports with validation
-- **API Reference**: Comprehensive skill and agent documentation
-
----
-
-## ⚙️ System Requirements
-
-### Required Dependencies
-
-```json
-{
-  "node": ">=18.0.0",
-  "redis": ">=6.0",
-  "sqlite3": ">=5.1.0"
-}
-```
-
-### Core Dependencies
-
-```json
-{
-  "@anthropic-ai/sdk": "^0.67.0",
-  "redis": "^5.8.3",
-  "better-sqlite3": "^12.4.1",
-  "commander": "^11.1.0",
-  "dotenv": "^17.2.3"
-}
-```
-
-### Optional
-
-- Z.ai provider account (for 95-98% cost savings)
-- Web portal dependencies (Socket.io for real-time monitoring)
-
----
-
-## 🎓 Learning & Adaptation
-
-### Playbook System
-
-**SQLite-Based Pattern Storage**
-- Similarity matching for task queries
-- Agent performance tracking per domain
-- Historical confidence data
-- Expected iterations prediction
-- 60%+ hit rate after 10 tasks
-
-### Continuous Improvement
-
-**Automatic After Each Sprint**
-1. Extract patterns from execution logs
-2. Identify bottlenecks and failures
-3. Rank agent performance
-4. Generate improvement recommendations
-5. Update playbook with successful strategies
-
-**Expected Learning Curve**
-- First execution: 5 iterations (no playbook)
-- Second execution: 4 iterations (initial pattern)
-- Fifth execution: 2-3 iterations (refined pattern)
-- Tenth execution: 2 iterations (optimized)
-
----
-
-## 🌐 Multi-Sprint & Epic Support
-
-### Epic Decomposition
-
-```bash
-/cfn-loop-epic "Build authentication system with OAuth2, 2FA, sessions"
-```
-
-**Automatic Processing**
-1. Parse natural language epic description
-2. Identify component boundaries
-3. Extract dependencies
-4. Generate sprint sequence (topological sort)
-5. Assign deliverables per sprint
-6. Estimate complexity per sprint
-
-### Sprint Execution
-
-**Focused Context Injection**
-- Sprint-specific deliverables (not entire epic)
-- Clear in_scope and out_of_scope boundaries
-- Sprint-level validation criteria
-- Prevents agents from over-implementing
-
-**Cross-Sprint Learning**
-- Sprint 2 learns from Sprint 1 patterns
-- Epic-level retrospective aggregation
-- Improved agent selection for later sprints
-
----
-
-## 📊 Total Package Value
-
-### Quantified Deliverables
-
-- ✅ **3 specialized coordinators**
-- ✅ **43 modular skills** (20 CFN v3 + 23 core)
-- ✅ **81 production-ready agents**
-- ✅ **8 slash commands**
-- ✅ **7 CLI binaries**
-- ✅ **39 validation hooks**
-- ✅ **60+ documentation files**
-
-### Capabilities
-
-- ✅ **6 domain support** with custom validation
-- ✅ **Dual-mode architecture** (cost vs visibility)
-- ✅ **95-98% cost savings** in CLI mode
-- ✅ **Self-learning playbook** system
-- ✅ **Real-time intervention** for stuck loops
-- ✅ **Zero-token coordination** via Redis
-- ✅ **Complete test infrastructure**
-
-### Proven Results
-
-- ✅ **30-40% iteration reduction** after 10 tasks
-- ✅ **88% context size reduction** at iteration 10
-- ✅ **33% faster convergence** vs v2
-- ✅ **60%+ playbook hit rate** after initial learning
-
----
-
-## 🏗️ Architecture Highlights
-
-### Modular Design
-
-- 43 independent skills with clear interfaces
-- 3 specialized coordinator agents
-- Minimal coupling between components
-- Easy to extend and customize
-
-### Event-Driven
-
-- Intervention triggers
-- Playbook queries
-- Retrospective analysis
-- Real-time monitoring
-
-### Learning System
-
-- SQLite playbook database
-- Pattern extraction after each sprint
-- Agent performance tracking
-- Continuous improvement
-
-### Multi-Domain
-
-- 6 task types supported
-- Domain-specific validation templates
-- Custom agent rosters per domain
-- Adaptive quality criteria
-
----
-
-## 🧪 Testing
-
-```bash
-# Run all tests
-npm test
-
-# Run specific test suites
-npm run test:unit
-npm run test:integration
-npm run test:e2e
-
-# CFN Loop end-to-end tests
-./tests/cfn-v3/test-e2e-cfn-loop.sh
-./tests/cfn-v3/test-coordinator-handoffs.sh
-./tests/cfn-v3/test-loop2-handoffs.sh
-./tests/cfn-v3/test-loop3-handoffs.sh
-./tests/cfn-v3/test-product-owner-handoffs.sh
-```
-
----
-
-## 🤝 Contributing
-
-We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-### Development Setup
-
-```bash
-# Clone repository
-git clone https://github.com/masharratt/claude-flow-novice.git
-cd claude-flow-novice
-
-# Install dependencies
-npm install
-
-# Run in development mode
-npm run dev
-
-# Build for production
-npm run build
-```
-
----
-
-## 📄 License
-
-MIT License - see [LICENSE](LICENSE) file for details.
-
----
-
-## 🆘 Support
-
-- **Documentation**: [Wiki](https://github.com/masharratt/claude-flow-novice/wiki)
-- **Issues**: [GitHub Issues](https://github.com/masharratt/claude-flow-novice/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/masharratt/claude-flow-novice/discussions)
-
----
-
-## 🗺️ Roadmap
-
-### v3.1.0 (Q1 2025)
-- [ ] Semantic playbook similarity (embeddings)
-- [ ] Parallel sprint execution
-- [ ] Natural language epic parsing
-
-### v3.2.0 (Q2 2025)
-- [ ] Dynamic sprint adjustment (merge/split)
-- [ ] Cross-sprint learning
-- [ ] Confidence prediction before execution
-
-### v3.3.0 (Q3 2025)
-- [ ] Sprint rollback capability
-- [ ] Epic-level re-planning
-- [ ] Advanced monitoring dashboard
-
----
-
-**Built with ❤️ for autonomous AI workflows**
-
-This is a production-ready, enterprise-grade AI agent orchestration system with proven 30-40% efficiency gains and comprehensive multi-domain support.