snow-flow 1.3.30 → 1.4.0

package/README.md

@@ -1,542 +1,239 @@
 # Snow-Flow: ServiceNow Hive-Mind Intelligence 🧠
 
-> **🔥 HOT FIX v1.3.30 Released**: Critical production blocker fixed! Update immediately with `npm update -g snow-flow`
+⚠️ **WARNING: FLOW CREATION REMOVED (v1.4.0+)** ⚠️
 
-**Snow-Flow** revolutionizes ServiceNow development through **claude-flow inspired hive-mind architecture**. One elegant command spawns intelligent AI agents that collaborate to build, test, and deploy professional ServiceNow solutions automatically.
+Flow Designer functionality has been removed due to critical issues.
+Please use ServiceNow's native Flow Designer interface directly.
+
+**Snow-Flow** provides intelligent AI agents that collaborate to build, test, and deploy ServiceNow solutions through **claude-flow inspired hive-mind architecture**.
 
 ## 🧠 The Hive-Mind Revolution
 
 **Inspired by claude-flow philosophy: "One Queen, many simple agents, simple memory, learn and adapt"**
 
 - 👑 **Queen Agent**: Master coordinator that analyzes objectives and spawns specialist agents
-- 🤖 **Worker Agents**: ServiceNow specialists (Widget Creator, Flow Builder, Script Writer, Security, Test)
+- 🤖 **Worker Agents**: ServiceNow specialists (Widget Creator, Script Writer, Security, Test)
 - 💾 **Shared Memory**: SQLite-based persistent coordination system
 - 🎯 **Claude Code Integration**: All coordination happens through Claude Code interface
 - 🚀 **One Command**: `snow-flow swarm "objective"` - everything else is automatic
 
-## 🚨 CRITICAL HOT FIX: v1.3.30 - BUG-001 Production Blocker RESOLVED! 🔥
+## ⚠️ BREAKING CHANGES v1.4.0
 
-### 🔥 Emergency Fix Released
+### Flow Creation Removed
 
-**BUG-001: "flowDef is not defined" Error - FIXED ✅**
-- **Critical Issue**: Flow deployments were completely blocked with runtime error
-- **Impact**: 100% deployment failure rate - no flows could be created
-- **Root Cause**: Missing `this.` prefix in CompleteFlowXMLGenerator class
-- **Fix**: All references to `flowDef` now properly use `this.flowDef`
-- **Result**: Flow deployments now work correctly!
+**Why This Change:**
+- 38 critical bugs found in flow creation functionality
+- 0% success rate in beta testing
+- Maintains stability of other features
 
-```bash
-# Update immediately to fix deployment issues
-npm update -g snow-flow
+**What Still Works:**
+- ✅ Widget development and deployment
+- ✅ Update Set management and tracking
+- ✅ ServiceNow authentication and session management
+- ✅ Table/field discovery and analysis
+- ✅ Multi-agent coordination via memory
+- ✅ General ServiceNow operations
 
-# Verify you have v1.3.30
-snow-flow --version
-```
+**Alternative Approach:**
+1. Use snow-flow for discovery and planning:
+   ```bash
+   snow-flow memory store flow_requirements "Need approval workflow with SLA tracking"
+   ```
+2. Create flows in ServiceNow Flow Designer interface directly
+3. Use snow-flow for other ServiceNow automation tasks
 
-## 🚨 CRITICAL FIXES: v1.3.28 - All Beta Testing Issues RESOLVED! ✅
-
-### 🎉 Complete Solution for ALL Three Critical Issues
-
-**Issue #1: Flow Deployment Creates Empty Flows - COMPLETELY FIXED ✅**
-- **Problem**: Flows were deploying "successfully" but were completely empty or missing 90% of features
-- **Root Cause**: Incomplete XML generation, wrong table versions (v1 instead of v2), missing encoding
-- **Solution**: New `CompleteFlowXMLGenerator` with:
-  - ✅ Correct v2 tables (sys_hub_action_instance_v2, sys_hub_trigger_instance_v2)
-  - ✅ Proper Base64+gzip encoding for action values
-  - ✅ Comprehensive label_cache structure
-  - ✅ ALL flow components fully supported
-- **Result**: Flows now deploy with 100% of requested features working!
-
-**Issue #2: Tool Registry Mapping Failures - COMPLETELY FIXED ✅**
-- **Problem**: Tool names between MCP providers were inconsistent causing failures
-- **Example**: `mcp__servicenow-operations__snow_table_schema_discovery` doesn't exist
-- **Solution**: New `MCPToolRegistry` with:
-  - ✅ Robust tool name resolution with aliases
-  - ✅ Fuzzy matching for partial names
-  - ✅ Provider-specific tool discovery
-  - ✅ Automatic mapping between naming conventions
-- **Result**: Tools always resolve correctly regardless of how they're referenced!
-
-**Issue #3: Metadata Response Failures - COMPLETELY FIXED ✅**
-- **Problem**: Deployment responses had sys_id always null, no API endpoints
-- **Root Cause**: ServiceNow responses vary widely, metadata extraction was incomplete
-- **Solution**: New `DeploymentMetadataHandler` with:
-  - ✅ Multiple fallback methods to find sys_id
-  - ✅ Searches by name, update set, and direct API
-  - ✅ Always returns complete metadata
-  - ✅ Comprehensive verification after deployment
-- **Result**: All deployments return complete, verified metadata!
-
-### 🚀 How It Works Now
+## 🚀 What Snow-Flow Does Best
 
+### Widget Development
 ```bash
-# One command creates COMPLETE flows with ALL features
-snow-flow swarm "create incident management flow with SLA tracking, automated assignment, knowledge base, and escalation"
-
-# Result:
-# ✅ Flow created with ALL 10+ requested features working
-# ✅ Proper sys_id returned: abc123-def456-...
-# ✅ API endpoint: https://instance.service-now.com/api/now/table/sys_hub_flow/abc123
-# ✅ UI URL: https://instance.service-now.com/flow-designer/abc123
-# ✅ Performance recommendations included
-# ✅ Complete verification of deployment
+# Create professional ServiceNow widgets
+snow-flow swarm "create incident dashboard widget with real-time updates"
 ```
 
-## ✨ What's New in v1.3.1 - Flow Designer XML Auto-Deployment COMPLETE!
-
-### 🚀 BREAKTHROUGH: Complete XML Update Set Auto-Import!
-- **✅ ZERO MANUAL STEPS**: One command imports, previews, and commits XML update sets automatically
-- **✅ FLOW DESIGNER INTEGRATION**: Automatic detection of Flow Designer artifacts in swarm commands
-- **✅ FULLY AUTOMATED FLOW DEPLOYMENT**: Complete workflow from natural language to live ServiceNow flow in one command
-- **✅ ZERO MANUAL STEPS**: XML generation, import, preview, and commit all happen automatically
-- **✅ INTELLIGENT SAFETY**: Auto-preview with problem detection, only commits if clean
-- **✅ GRACEFUL FALLBACKS**: Provides manual instructions if auto-deployment fails
-
-### 🔄 Fully Automated Flow Workflow (NEW v1.3.17!)
+### Update Set Management  
 ```bash
-# Single command creates AND deploys flow automatically!
-snow-flow swarm "create approval workflow for equipment requests"
-
-# Complete output shows:
-# 🔧 Flow Designer Detected - Using XML-First Approach!
-# ✅ XML Generated & Auto-Deployed to ServiceNow!
-# 🎉 Flow ready in Flow Designer!
-
-# ✅ Zero manual steps: Generate → Import → Preview → Commit (only if clean)
+# Track and manage update sets
+snow-flow auth login
+snow-flow update-set create "Widget Development" "Dashboard widgets and improvements"
 ```
 
-### 🚀 Previous Release: v1.1.93 - Revolutionary Parallel Agent Spawning WORKING!
-
-#### 🚀 BREAKTHROUGH: 6+ Parallel Agents Working Simultaneously!
-- **✅ PROVEN RESULTS**: 6+ specialized agents spawn automatically for widget development
-- **✅ 2.8x SPEEDUP**: Demonstrated 2.8x faster development vs single-agent approach
-- **✅ SPECIALIZED TEAMS**: widget-creator, css-specialist, backend-specialist, frontend-specialist, integration-specialist, performance-specialist, ui-ux-specialist, tester
-- **✅ 100% DETECTION**: Enhanced detection logic - no more missed parallelization opportunities
-- **✅ INTELLIGENT 403 HANDLING**: Gap Analysis Engine integration for automatic permission issue resolution
-- **✅ MEMORY TOOLS FIXED**: ServiceNow Memory MCP server added to template system
-
-### 🚀 Previous Release: v1.1.90 - Parallel Agent Engine Foundation
-- **Parallel Engine Architecture**: Core foundation for intelligent agent spawning
-- **Task Analysis System**: Detects opportunities for specialized breakdown
-- **Agent Coordination**: Shared memory system for multi-agent collaboration
-- **Shared Memory Coordination**: All parallel agents coordinate seamlessly through shared memory system
-
-### ⚡ Execution Strategies
-- **Wave-based**: Sequential waves of parallel agents for structured work
-- **Concurrent**: All agents work simultaneously for maximum speed
-- **Pipeline**: Agent handoffs with overlap for continuous workflow  
-- **Hybrid**: Intelligent mix of strategies based on task analysis
-
-### 🧠 Learning & Optimization
-- **Performance Tracking**: Stores execution results to improve future parallelization decisions
-- **Workload Balancing**: Intelligent distribution across agent teams with utilization monitoring
-- **Graceful Fallback**: Automatically falls back to sequential execution when beneficial
-
-## 🧠 Previous Major Release: v1.1.88 - Intelligent Gap Analysis Revolution
-
-### 🧠 REVOLUTIONARY: Intelligent Gap Analysis Engine
-- **Beyond MCP Tools**: Automatically detects ALL ServiceNow configurations needed beyond standard MCP tools
-- **60+ Configuration Types**: System properties, LDAP/SAML auth, database indexes, navigation, forms, ACLs, and more
-- **Auto-Resolution Engine**: Attempts automatic configuration via ServiceNow APIs for safe operations
-- **Manual Instructions Generator**: Creates detailed step-by-step guides with role requirements and risk assessment
-- **Queen Agent Integration**: Built into every Queen Agent execution - no additional commands needed
-
-### 🎯 Complete ServiceNow Configuration Coverage
-- **🔐 Authentication**: LDAP, SAML, OAuth providers, SSO, MFA configurations
-- **🗄️ Database**: Indexes, views, partitioning, performance analytics, system properties
-- **🧭 Navigation**: Application menus, modules, form layouts, UI actions, policies
-- **📧 Integration**: Email templates, web services, import sets, transform maps
-- **🔄 Workflow**: Activities, transitions, SLA definitions, escalation rules
-
-### 🤖 Intelligent Automation
-- **Requirements Analysis**: AI-powered parsing of objectives to identify all needed configurations
-- **MCP Coverage Analysis**: Maps what current tools can handle vs manual setup requirements  
-- **Risk Assessment**: Evaluates complexity and safety of each configuration
-- **Environment Awareness**: Provides dev/test/prod specific guidance and warnings
-
-### 🔧 Agent-Based MCP Integration
-- **Memory-Aware MCPs**: All 11 MCP servers now integrate with agent coordination
-- **Progress Reporting**: Real-time progress updates to Queen Agent
-- **No Mock Data**: All operations use real ServiceNow (removed all placeholders)
-- **Error Recovery**: Comprehensive fallback strategies with Queen intervention
-
-### 🚀 Enhanced CLI Orchestration
-- **Queen Agent Prompts**: Swarm command generates comprehensive orchestration instructions
-- **Session Management**: Unique session IDs with progress tracking
-- **Status Monitoring**: `snow-flow swarm-status <sessionId>` for real-time monitoring
-- **Memory Coordination**: All agents communicate through shared SQLite memory
-
-## 🤖 Agent Ecosystem
-
-### 👑 Queen Agent (Master Coordinator)
-- **Objective Analysis**: Analyzes natural language objectives and determines complexity
-- **Agent Spawning**: Dynamically spawns required specialist agents based on requirements
-- **Progress Monitoring**: Real-time tracking of task completion and agent coordination
-- **Memory Management**: Stores patterns and learns from successful executions
-- **Error Recovery**: Makes strategic decisions when agents encounter problems
-
-### 🎨 Widget Creator Agent
-- **HTML Templates**: Creates responsive ServiceNow Service Portal widgets
-- **Server Scripts**: Develops optimized server-side data processing logic
-- **CSS Styling**: Implements professional styling with Chart.js integration
-- **Deployment**: Uses `snow_deploy` MCP tools for direct ServiceNow deployment
-
-### 🔄 Flow Builder Agent
-- **Flow Design**: Creates Flow Designer workflows with intelligent structure
-- **Trigger Configuration**: Sets up optimal triggers (record events, scheduled, manual)
-- **Approval Processes**: Implements complex approval hierarchies with escalation
-- **Integration**: Uses `snow_xml_flow_from_instruction` with auto-deployment for maximum reliability
-
-### 📝 Script Writer Agent
-- **Business Rules**: Creates optimized business logic with performance considerations
-- **Script Includes**: Develops reusable server-side utilities with proper class structure
-- **Client Scripts**: Implements UI behavior and validation logic
-- **Performance**: Automatic optimization recommendations and best practices
-
-### 🛡️ Security Agent
-- **Vulnerability Scanning**: Scans for XSS, SQL injection, hardcoded credentials
-- **Access Control**: Validates permissions and role-based security
-- **Compliance**: Checks SOX, GDPR, HIPAA compliance requirements
-- **Remediation**: Generates actionable security improvement plans
-
-### 🧪 Test Agent
-- **Test Scenarios**: Creates comprehensive test cases (positive, negative, edge cases)
-- **Mock Data**: Generates realistic test data for validation
-- **Performance Testing**: Validates response times and resource usage
-- **Integration Testing**: Tests cross-component interactions and workflows
-
-## 💾 Memory System Architecture
-
-### SQLite-Based Coordination
-```sql
--- Agent coordination and communication
-agent_coordination: Track agent status, progress, and assignments
-servicenow_artifacts: Store created widgets, flows, scripts with full metadata
-agent_messages: Inter-agent communication and handoff coordination
-shared_context: Session-wide shared data and configuration
-deployment_history: Complete audit trail of all ServiceNow operations
-agent_dependencies: Manage complex task dependencies and ordering
-performance_metrics: Real-time performance tracking and optimization
+### Table Discovery
+```bash
+# Analyze ServiceNow table structures
+snow-flow swarm "analyze incident table fields and relationships"
 ```
 
-### Memory Usage Patterns
-```javascript
-// Agents store context for coordination
-Memory.store("widget_requirements", {
-  type: "incident_dashboard",
-  charts: ["pie", "bar", "timeline"],
-  responsive: true
-});
-
-// Other agents read and build upon context
-const requirements = Memory.get("widget_requirements");
-// Agent creates widget based on shared requirements
+### Multi-Agent Coordination
+```bash
+# Coordinate multiple development tasks
+snow-flow swarm "analyze requirements and create widget prototypes"
 ```
 
-## 🚀 Quick Start
-
-### Prerequisites
-- Node.js 18+ and npm
-- ServiceNow instance with admin access
-- OAuth application configured in ServiceNow
-
-### Installation & Setup
+## 🛠️ Installation
 
 ```bash
-# Install Snow-Flow globally
+# Install globally
 npm install -g snow-flow
 
-# Initialize with complete hive-mind environment
-snow-flow init --sparc
-
-# Configure ServiceNow credentials (.env file)
-SNOW_INSTANCE=dev123456
-SNOW_CLIENT_ID=your_oauth_client_id
-SNOW_CLIENT_SECRET=your_oauth_client_secret
-SNOW_USERNAME=admin
-SNOW_PASSWORD=admin_password
+# Verify installation
+snow-flow --version
 
 # Authenticate with ServiceNow
 snow-flow auth login
-
-# 🎉 Experience the hive-mind intelligence with Gap Analysis!
-snow-flow swarm "Create incident management dashboard with real-time charts"
-
-# 🧠 NEW: Advanced example showing Gap Analysis Engine
-snow-flow queen "create ITSM solution with LDAP authentication and custom approval workflows"
-
-# 🚀 NEW: Fully automated Flow Designer deployment (v1.3.17!)
-snow-flow swarm "create approval workflow for equipment requests"
-# ✅ Above command automatically deploys flow to ServiceNow! Zero manual steps.
 ```
 
-### 🧠 What You'll See with Gap Analysis Engine
+## 📖 Core Commands
 
+### Authentication
 ```bash
-snow-flow queen "create incident management with LDAP authentication"
-
-🧠 Step 4: Running Intelligent Gap Analysis...
-📊 Gap Analysis Complete:
-  • Total Requirements: 12
-  • MCP Coverage: 67%
-  • Automated: 6 configurations  
-  • Manual Work: 4 items
-
-✅ Automatically Configured:
-  • System property: glide.ui.incident_management created
-  • Navigation module: Incident Management added to Service Desk
-  • Email template: incident_notification configured
-  • Database index: incident.priority_state for performance
-  • Form layout: incident form sections optimized
-  • UI action: "Escalate Priority" button added
-
-📋 Manual Configuration Required:
-  • LDAP authentication setup (high-risk operation)
-  • SSO configuration with Active Directory  
-  • Custom ACL rules for incident priority restrictions
-  • Email server configuration for notifications
-
-📚 Detailed Manual Guides Available:
-  📖 Configure LDAP Authentication - 25 minutes
-     Risk: high | Roles: security_admin, admin
-  📖 Setup SSO with Active Directory - 45 minutes
-     Risk: high | Roles: security_admin
-  📖 Create Custom ACL Rules - 15 minutes  
-     Risk: medium | Roles: admin
-  📖 Configure Email Server - 20 minutes
-     Risk: low | Roles: email_admin
-
-💡 Recommendations:
-  • Test LDAP configuration in development environment first
-  • Coordinate with security team for SSO setup
-  • Review ACL rules with business stakeholders
+snow-flow auth login                    # Login to ServiceNow
+snow-flow auth status                   # Check authentication status
 ```
 
-## 🎯 Core Commands
-
-### 🧠 Hive-Mind Orchestration
+### Widget Development
 ```bash
-# Primary command - spawns Queen Agent with specialist workers
-snow-flow swarm "objective"
-
-# Monitor swarm progress
-snow-flow swarm-status <sessionId>
-
-# System status and health
-snow-flow status
+snow-flow swarm "create widget..."      # Create ServiceNow widgets
+```
 
-# Memory management
-snow-flow memory stats
-snow-flow memory export <file>
+### Update Sets
+```bash
+snow-flow update-set create <name>      # Create new update set
+snow-flow update-set list               # List update sets
+snow-flow update-set switch <id>        # Switch to update set
 ```
 
-### 🚀 NEW: Fully Automated Flow Deployment (v1.3.17!)
+### Discovery & Analysis
 ```bash
-# Single command creates AND deploys flows automatically!
-snow-flow swarm "create approval workflow for equipment requests"
-
-# What happens automatically:
-# 1. ✅ Detects Flow Designer task
-# 2. ✅ Generates production-ready XML 
-# 3. ✅ Imports to ServiceNow as remote update set
-# 4. ✅ Previews for conflicts
-# 5. ✅ Auto-commits if clean
-# 6. ✅ Reports deployment status
-
-# Manual deployment (fallback only): snow-flow deploy-xml filename.xml
+snow-flow swarm "analyze table..."      # Analyze ServiceNow tables
+snow-flow swarm "discover fields..."    # Field discovery
 ```
 
-### 🚀 Intelligent Features (Enabled by Default)
-- **🧠 Gap Analysis Engine**: Automatically detects ALL ServiceNow configurations beyond MCP tools
-- **🤖 Auto-Resolution**: Attempts automatic configuration of system properties, navigation, auth
-- **📚 Manual Guides**: Generates detailed step-by-step instructions for complex setups
-- **🚀 XML Auto-Deployment**: Complete XML update set import workflow with safety controls
-- **Smart Discovery**: Automatically discovers and reuses existing artifacts
-- **Live Testing**: Real-time testing during development on your ServiceNow instance
-- **Auto Deploy**: Automatic deployment when ready (safe with update sets)
-- **Auto Rollback**: Automatic rollback on failures with backup restoration
-- **Shared Memory**: All agents share context and coordination state
-- **Progress Monitoring**: Real-time progress tracking and status updates
-
-### 🎛️ Advanced Options
+### Memory Management
 ```bash
-# Enable automatic permission escalation for enterprise features
-snow-flow swarm "create global workflow" --auto-permissions
-
-# Disable specific features when needed
-snow-flow swarm "test widget locally" --no-auto-deploy --no-live-testing
-
-# Maximum control
-snow-flow swarm "complex integration" \
-  --max-agents 8 \
-  --strategy development \
-  --mode distributed \
-  --parallel \
-  --auto-permissions
+snow-flow memory store <key> <data>     # Store persistent data
+snow-flow memory get <key>              # Retrieve data
+snow-flow memory list                   # List all keys
 ```
 
-## 🔧 Configuration
+## 🏗️ Architecture
 
-### ServiceNow Connection
-Create `.env` file in your project:
-```env
-SNOW_INSTANCE=dev123456
-SNOW_CLIENT_ID=your_oauth_client_id
-SNOW_CLIENT_SECRET=your_oauth_client_secret
-SNOW_USERNAME=admin
-SNOW_PASSWORD=admin_password
-```
+### Agent Types
+- **Queen Agent**: Master coordinator and decision maker
+- **Widget Creator**: ServiceNow widget specialist
+- **Script Writer**: Business rules and client scripts
+- **Security Agent**: Access controls and security policies
+- **Test Agent**: Automated testing and validation
 
-### OAuth Setup in ServiceNow
-1. Navigate to System OAuth > Application Registry
-2. Create new OAuth application
-3. Set redirect URI to `http://localhost:3000/oauth/callback`
-4. Note the Client ID and Client Secret
-5. Grant necessary scopes for your development needs
+### Memory System
+- **SQLite Backend**: Persistent cross-session memory
+- **Hierarchical Storage**: Organized by domain and context
+- **Agent Coordination**: Shared knowledge between agents
 
-## 🎯 Usage Examples
+### ServiceNow Integration
+- **OAuth 2.0**: Secure authentication
+- **REST APIs**: Direct ServiceNow integration
+- **Update Sets**: Change tracking and deployment
+- **Table API**: Schema discovery and analysis
 
-### Widget Development
-```bash
-# Complete widget with intelligent agent coordination
-snow-flow swarm "Create incident dashboard widget with pie charts and filter options"
-
-# The Queen Agent will:
-# 1. Analyze objective and spawn Widget Creator + Test Agent
-# 2. Widget Creator builds responsive HTML/CSS/JS with Chart.js
-# 3. Test Agent creates comprehensive test scenarios
-# 4. Automatic deployment to ServiceNow with Update Set tracking
-```
+## 🔧 Configuration
 
-### Flow Creation & XML Deployment
+### Environment Setup
 ```bash
-# Complex approval workflow with automatic XML generation
-snow-flow swarm "Build approval flow for equipment requests with manager and finance approval"
-
-# The Queen Agent will:
-# 1. Spawn Flow Builder + Security Agent
-# 2. Flow Builder designs multi-step approval process
-# 3. Security Agent validates permissions and compliance
-# 4. Automatic XML generation AND deployment to ServiceNow
-# 5. Flow ready in Flow Designer - zero manual steps!
-
-# 🚀 NEW: Fully automated - no separate deployment command needed!
-
-# ✅ Automatic process:
-# • Import XML to ServiceNow
-# • Load remote update set  
-# • Preview changes & check for conflicts
-# • Commit automatically if clean (or prompt if issues found)
+# Create configuration
+snow-flow config init
+
+# Set ServiceNow instance
+snow-flow config set instance your-instance.service-now.com
+
+# Configure OAuth
+snow-flow config set oauth true
 ```
 
-### Complete Solutions
+### MCP Integration
+Snow-Flow includes Model Context Protocol (MCP) servers for extended functionality:
+
 ```bash
-# End-to-end solution development
-snow-flow swarm "Create complete ITSM incident management solution with dashboards, automation, and reporting"
-
-# The Queen Agent will:
-# 1. Analyze complexity and spawn all required agents
-# 2. Coordinate parallel development of multiple components
-# 3. Ensure integration between widgets, flows, and scripts
-# 4. Comprehensive testing and phased deployment
+# Start MCP services
+snow-flow mcp start
+
+# Check MCP status
+snow-flow mcp status
 ```
 
-## 🏗️ Architecture
+## 🧪 Development Workflows
 
-### Hive-Mind Coordination Flow
-1. **CLI Analysis**: User runs `snow-flow swarm "objective"`
-2. **Queen Activation**: Queen Agent analyzes objective and determines requirements
-3. **Agent Spawning**: Queen spawns specialist agents based on complexity assessment
-4. **Memory Initialization**: SQLite memory system activated for coordination
-5. **Parallel Execution**: Agents work independently while sharing context through memory
-6. **Progress Monitoring**: Real-time status updates via shared memory state
-7. **ServiceNow Integration**: Agents use 11 specialized MCP servers for operations
-8. **Completion**: Final artifacts delivered with comprehensive audit trail
-
-### Memory-Driven Coordination
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    Snow-Flow Hive-Mind System                   │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────┐  │
-│  │   Claude Code   │◄──►│  Snow-Flow CLI  │◄──►│ ServiceNow  │  │
-│  │   Interface     │    │  Orchestrator   │    │  Instance   │  │
-│  └─────────────────┘    └─────────────────┘    └─────────────┘  │
-│           │                       │                      │      │
-│           ▼                       ▼                      ▼      │
-│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────┐  │
-│  │  Swarm Memory   │◄──►│  Queen Agent    │◄──►│  MCP Tools  │  │
-│  │   (SQLite)      │    │  Coordinator    │    │  (11 MCPs)  │  │
-│  └─────────────────┘    └─────────────────┘    └─────────────┘  │
-│           │                       │                             │
-│           ▼                       ▼                             │
-│  ┌─────────────────────────────────────────────────────────────┤
-│  │              ServiceNow Specialist Agents                   │
-│  │                                                             │
-│  │  Widget Creator  │  Flow Builder  │  Script Writer        │  │
-│  │  Security Agent  │  Test Agent    │  [Future Agents]      │  │
-│  └─────────────────────────────────────────────────────────────┘
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
+### Widget Development Workflow
+```bash
+# 1. Plan widget requirements
+snow-flow memory store widget_plan "Dashboard requirements and specs"
 
-## 🔧 Development
+# 2. Create widget with swarm
+snow-flow swarm "create incident dashboard widget with charts and filtering"
 
-### Project Structure
-```
-snow-flow/
-├── src/
-│   ├── agents/           # Queen Agent and specialist agents
-│   ├── memory/           # SQLite-based coordination system
-│   ├── mcp/             # 11 ServiceNow MCP servers
-│   ├── cli/             # Enhanced CLI with Queen orchestration
-│   ├── config/          # Configuration management
-│   ├── health/          # System health monitoring
-│   └── monitoring/      # Performance tracking
-├── SNOW_FLOW_ARCHITECTURE.md  # Complete system architecture
-├── MCP_ARCHITECTURE.md        # Agent-specific MCP design
-└── CLAUDE.md                  # Development configuration
+# 3. Test and refine
+snow-flow swarm "test widget functionality and improve performance"
 ```
 
-### Build and Test
+### Analysis Workflow
 ```bash
-# Build the project
-npm run build
+# 1. Discover table structure
+snow-flow swarm "analyze incident table fields and relationships"
 
-# Run tests
-npm run test
+# 2. Plan improvements
+snow-flow memory store analysis_results "Field analysis and recommendations"
 
-# Type checking
-npm run typecheck
+# 3. Document findings
+snow-flow swarm "create documentation for table analysis"
+```
 
-# Memory system test
-npm run test:memory
+## 📚 Documentation
 
-# MCP integration test
-npm run test:mcp-integration
-```
+- **Authentication**: Setup OAuth and basic auth
+- **Widget Development**: Create and deploy ServiceNow widgets
+- **Update Sets**: Manage change tracking
+- **Memory System**: Cross-agent coordination
+- **MCP Integration**: Extended functionality
 
 ## 🤝 Contributing
 
-We welcome contributions to the Snow-Flow hive-mind ecosystem! Please read our contributing guidelines and submit PRs for new agents, MCP enhancements, or architecture improvements.
+Snow-Flow is open source. Contributions welcome!
 
-### Priority Areas
-- Additional specialist agents (Integration, Reporting, etc.)
-- Enhanced memory patterns and learning algorithms
-- Advanced Queen Agent decision-making capabilities
-- ServiceNow-specific optimizations and best practices
+```bash
+# Clone repository
+git clone https://github.com/groeimetai/snow-flow.git
+
+# Install dependencies
+npm install
 
-## 📝 License
+# Build project
+npm run build
+
+# Run tests
+npm test
+```
+
+## 📄 License
 
 MIT License - see LICENSE file for details.
 
-## 🚀 Future Vision
+## 🆘 Support
+
+- **GitHub Issues**: https://github.com/groeimetai/snow-flow/issues  
+- **Documentation**: See /docs directory in repository
+- **Examples**: See /examples directory
+
+## 🔮 Roadmap
 
-Snow-Flow will become the **definitive AI-driven ServiceNow development platform**, where developers describe any ServiceNow objective in natural language and watch intelligent agents collaborate to build, test, and deploy professional solutions automatically.
+### Planned Enhancements
+- Enhanced widget templates and patterns
+- Advanced ServiceNow API integrations  
+- Extended table analysis capabilities
+- Improved multi-agent coordination
+- Enterprise security features
 
-**Core Promise**: "Describe what you want in ServiceNow, and our AI swarm will build it for you."
+### Flow Designer Notice
+Flow creation functionality has been permanently removed. Users should use ServiceNow's native Flow Designer interface directly for flow development.
 
 ---
 
-*Experience the future of ServiceNow development with Snow-Flow's hive-mind intelligence.* 🧠✨
+**Snow-Flow v1.4.0** - Focused, stable, reliable ServiceNow development automation.