claude-flow-novice 1.3.0 → 1.3.2

package/.claude-flow-novice/preferences/resource-delegation.json

@@ -0,0 +1,120 @@
+{
+  "resourceDelegation": {
+    "mode": "adaptive",
+    "description": "Controls how resource-heavy commands are executed across swarm agents",
+    "options": {
+      "distributed": {
+        "name": "Distributed Execution",
+        "description": "All agents execute heavy commands simultaneously",
+        "pros": ["Faster parallel execution", "Better resource utilization"],
+        "cons": ["Higher system load", "Potential resource conflicts"],
+        "bestFor": ["Light workloads", "High-performance systems", "Independent tasks"]
+      },
+      "single-delegate": {
+        "name": "Single Agent Delegation",
+        "description": "One agent executes heavy commands, shares results with others",
+        "pros": ["Lower system load", "Prevents resource conflicts", "Better reliability"],
+        "cons": ["Sequential execution", "Single point of failure"],
+        "bestFor": ["Resource-constrained systems", "Complex builds", "Heavy test suites"]
+      },
+      "adaptive": {
+        "name": "Adaptive Resource Management",
+        "description": "Automatically chooses the best strategy based on current conditions",
+        "pros": ["Optimal performance", "Dynamic adaptation", "Balanced resource usage"],
+        "cons": ["Slight overhead for decision-making"],
+        "bestFor": ["Most use cases", "Variable workloads", "Production environments"]
+      }
+    },
+    "heavyCommandThreshold": 5000,
+    "maxConcurrentHeavyCommands": 2,
+    "preferredDelegate": "auto",
+    "resourceLimits": {
+      "cpu": 80,
+      "memory": 75,
+      "network": 90,
+      "description": "System resource thresholds that trigger single-delegate mode"
+    }
+  },
+  "commandCategories": {
+    "test": {
+      "commands": ["npm test", "npm run test", "jest", "vitest", "pytest", "cargo test", "go test", "mvn test"],
+      "defaultStrategy": "single-delegate",
+      "reasoning": "Test suites often require substantial resources and can conflict when run in parallel"
+    },
+    "build": {
+      "commands": ["npm run build", "webpack", "vite build", "tsc", "cargo build", "go build", "gradle build"],
+      "defaultStrategy": "adaptive",
+      "reasoning": "Build processes vary in resource requirements; adaptive mode optimizes based on conditions"
+    },
+    "compile": {
+      "commands": ["tsc", "javac", "gcc", "clang", "rustc"],
+      "defaultStrategy": "single-delegate",
+      "reasoning": "Compilation can be memory-intensive and benefit from dedicated resources"
+    },
+    "lint": {
+      "commands": ["eslint", "prettier", "flake8", "black", "clippy"],
+      "defaultStrategy": "distributed",
+      "reasoning": "Linting is typically lightweight and can be safely distributed"
+    },
+    "package": {
+      "commands": ["npm pack", "docker build", "zip", "tar"],
+      "defaultStrategy": "single-delegate",
+      "reasoning": "Package creation often involves file system operations that can conflict"
+    }
+  },
+  "delegateSelection": {
+    "strategies": {
+      "auto": "Automatically select best agent based on performance metrics and current load",
+      "performance-optimized": "Always select the highest-performing agent",
+      "round-robin": "Rotate delegate selection among available agents",
+      "load-balanced": "Select agent with lowest current resource utilization",
+      "capability-based": "Select agent with most relevant capabilities for the task"
+    },
+    "selectionCriteria": {
+      "performanceWeight": 0.4,
+      "loadWeight": 0.3,
+      "capabilityWeight": 0.2,
+      "availabilityWeight": 0.1
+    }
+  },
+  "monitoring": {
+    "trackPerformance": true,
+    "collectMetrics": true,
+    "alertThresholds": {
+      "highCpuUsage": 85,
+      "highMemoryUsage": 90,
+      "executionTimeout": 300000,
+      "consecutiveFailures": 3
+    },
+    "optimizationHints": {
+      "enableAutoTuning": true,
+      "suggestConfigChanges": true,
+      "trackSuccessPatterns": true
+    }
+  },
+  "examples": {
+    "scenarios": [
+      {
+        "name": "Large Test Suite",
+        "description": "Running comprehensive test suites with high memory requirements",
+        "recommendedMode": "single-delegate",
+        "commands": ["npm run test:all", "pytest tests/", "cargo test --release"],
+        "reasoning": "Prevents memory conflicts and ensures consistent test environment"
+      },
+      {
+        "name": "Multi-Package Build",
+        "description": "Building multiple packages or modules simultaneously",
+        "recommendedMode": "adaptive",
+        "commands": ["lerna run build", "nx run-many --target=build"],
+        "reasoning": "Adapts to system load and optimizes parallel vs sequential execution"
+      },
+      {
+        "name": "Development Workflow",
+        "description": "Standard development tasks like linting and type checking",
+        "recommendedMode": "distributed",
+        "commands": ["eslint src/", "prettier --check", "tsc --noEmit"],
+        "reasoning": "These lightweight tasks benefit from parallel execution"
+      }
+    ]
+  }
+}

package/.claude-flow-novice/preferences/team-shared.json

@@ -0,0 +1,195 @@
+{
+  "teamCollaboration": {
+    "description": "Team collaboration and preference sharing settings",
+    "enabled": false,
+    "currentTeam": null,
+    "memberInfo": {
+      "id": null,
+      "name": null,
+      "role": "member",
+      "joinedAt": null
+    },
+    "syncSettings": {
+      "autoSync": true,
+      "syncFrequency": "on-change",
+      "conflictResolution": "prompt",
+      "backupBeforeSync": true
+    },
+    "collaborationModes": {
+      "developer": {
+        "name": "Developer Team",
+        "description": "Optimized for development teams with focus on code quality",
+        "sharedPreferences": [
+          "tone.style",
+          "documentation.verbosity",
+          "languages.auto_setup_linting",
+          "resourceDelegation.mode",
+          "customizations.message_filters"
+        ],
+        "benefits": [
+          "Consistent code quality standards",
+          "Shared linting and formatting rules",
+          "Unified build and test processes",
+          "Standardized agent behavior"
+        ]
+      },
+      "research": {
+        "name": "Research Team",
+        "description": "Optimized for research teams with comprehensive documentation",
+        "sharedPreferences": [
+          "documentation.verbosity",
+          "tone.technical_depth",
+          "guidance.experience_level",
+          "workflow.analytics_driven"
+        ],
+        "benefits": [
+          "Consistent documentation standards",
+          "Shared research methodologies",
+          "Unified analysis approaches",
+          "Collaborative knowledge building"
+        ]
+      },
+      "enterprise": {
+        "name": "Enterprise Team",
+        "description": "Standardized settings for enterprise environments",
+        "sharedPreferences": [
+          "tone.style",
+          "documentation.verbosity",
+          "resourceDelegation",
+          "customizations",
+          "languages.auto_setup_linting"
+        ],
+        "benefits": [
+          "Enterprise compliance",
+          "Standardized workflows",
+          "Centralized policy management",
+          "Consistent user experience"
+        ]
+      },
+      "flexible": {
+        "name": "Flexible Team",
+        "description": "Minimal shared preferences, maximum individual flexibility",
+        "sharedPreferences": [
+          "tone.style",
+          "resourceDelegation.mode"
+        ],
+        "benefits": [
+          "Individual customization freedom",
+          "Minimal sync conflicts",
+          "Personal workflow optimization",
+          "Loose team coordination"
+        ]
+      }
+    },
+    "conflictResolutionStrategies": {
+      "vote": {
+        "name": "Team Voting",
+        "description": "Team members vote to resolve conflicts",
+        "bestFor": ["Democratic teams", "Equally experienced members"]
+      },
+      "merge": {
+        "name": "Smart Merging",
+        "description": "Automatically merge compatible preferences",
+        "bestFor": ["Compatible preferences", "Array/object values"]
+      },
+      "admin-override": {
+        "name": "Admin Override",
+        "description": "Team admin's preferences take precedence",
+        "bestFor": ["Hierarchical teams", "Enterprise environments"]
+      },
+      "individual-choice": {
+        "name": "Individual Choice",
+        "description": "Preserve individual preferences",
+        "bestFor": ["Flexible teams", "Personal customization priority"]
+      },
+      "prompt": {
+        "name": "Interactive Resolution",
+        "description": "Prompt user to choose resolution method",
+        "bestFor": ["Ad-hoc collaboration", "Context-dependent decisions"]
+      }
+    }
+  },
+  "examples": {
+    "workflows": [
+      {
+        "name": "New Team Setup",
+        "steps": [
+          "Team lead creates team with claude-flow-novice team create 'Dev Team'",
+          "Team lead configures collaboration mode and shared preferences",
+          "Members join using team ID",
+          "Initial preference sync occurs automatically",
+          "Team begins collaborative development with synchronized settings"
+        ]
+      },
+      {
+        "name": "Adding New Shared Preference",
+        "steps": [
+          "Team member proposes new shared preference",
+          "Admin adds preference to shared list",
+          "Next sync propagates new preference to all members",
+          "Conflicts resolved using team's resolution strategy"
+        ]
+      },
+      {
+        "name": "Resolving Conflicts",
+        "steps": [
+          "Member's local changes conflict with team preferences",
+          "Sync process detects conflicts",
+          "Resolution strategy applied (vote/merge/admin/individual)",
+          "Resolved preferences saved and propagated",
+          "Team continues with synchronized settings"
+        ]
+      }
+    ],
+    "useCases": [
+      {
+        "scenario": "Development Team with 5 Members",
+        "recommendation": "developer mode",
+        "sharedPreferences": [
+          "code formatting rules",
+          "linting standards",
+          "build processes",
+          "testing approaches"
+        ],
+        "benefits": "Consistent code quality and development practices"
+      },
+      {
+        "scenario": "Research Group with Documentation Focus",
+        "recommendation": "research mode",
+        "sharedPreferences": [
+          "documentation verbosity",
+          "technical depth",
+          "analysis standards"
+        ],
+        "benefits": "Unified research methodology and documentation standards"
+      },
+      {
+        "scenario": "Enterprise Team with Compliance Requirements",
+        "recommendation": "enterprise mode",
+        "sharedPreferences": [
+          "all major settings",
+          "security policies",
+          "compliance standards"
+        ],
+        "benefits": "Centralized control and regulatory compliance"
+      }
+    ]
+  },
+  "tips": {
+    "bestPractices": [
+      "Start with minimal shared preferences and add gradually",
+      "Choose collaboration mode based on team structure and needs",
+      "Regular sync prevents large conflict accumulation",
+      "Use descriptive team names and member names for clarity",
+      "Backup individual preferences before major sync operations",
+      "Review conflict resolutions periodically to ensure effectiveness"
+    ],
+    "troubleshooting": [
+      "Sync lock timeout: Wait 30 seconds and retry",
+      "Conflict resolution deadlock: Use admin override temporarily",
+      "Missing team configuration: Check team ID accuracy",
+      "Permission errors: Verify team membership and role",
+      "Preference corruption: Restore from backup"
+    ]
+  }
+}

package/.claude-flow-novice/preferences/user-global.json

@@ -0,0 +1,247 @@
+{
+  "version": "1.0.0",
+  "created": "2025-09-24",
+  "_description": "Claude Flow Novice User Preferences - Controls behavior, communication style, and automation settings",
+
+  "preferences": {
+    "documentation": {
+      "_description": "Controls how much documentation is generated and what types are allowed",
+      "_used_in": [
+        "src/preferences/preference-manager.js:283,419",
+        "src/preferences/preference-wizard.js:174,485",
+        "src/hooks/enhanced/personalization-hooks.js"
+      ],
+      "verbosity": "moderate",
+      "_verbosity_options": ["minimal", "moderate", "comprehensive"],
+      "_verbosity_description": "Amount of documentation detail - minimal=essential only, moderate=balanced, comprehensive=detailed",
+
+      "auto_generate_md": false,
+      "_auto_generate_md_description": "Whether agents automatically create .md files without being asked",
+      "_auto_generate_md_used_in": ["src/filters/content-filters.js (controls .md generation limits)"],
+
+      "allowed_md_types": ["README", "API_DOCS", "CHANGELOG"],
+      "_allowed_md_types_description": "Types of markdown files agents can create. Prevents unwanted documentation spam",
+      "_allowed_md_types_used_in": ["src/filters/content-filters.js (file type validation)"],
+
+      "max_md_files_per_session": 3,
+      "_max_md_files_per_session_description": "Maximum .md files agents can create in one session to prevent documentation overload",
+      "_max_md_files_per_session_used_in": ["src/filters/content-filters.js (session limits)"]
+    },
+
+    "tone": {
+      "_description": "Controls communication style and how agents respond to you",
+      "style": "professional",
+      "_style_options": ["professional", "casual", "minimal-feedback"],
+      "_style_description": "Communication formality - professional=structured responses, casual=conversational, minimal-feedback=brief answers",
+
+      "celebration_level": "minimal",
+      "_celebration_level_options": ["none", "minimal", "moderate", "enthusiastic"],
+      "_celebration_level_description": "How much agents celebrate successes - none=no celebrations, minimal=brief acknowledgment, enthusiastic=lots of emojis",
+
+      "feedback_verbosity": "concise",
+      "_feedback_verbosity_options": ["terse", "concise", "detailed", "verbose"],
+      "_feedback_verbosity_description": "Length of agent responses - terse=one-liners, concise=brief explanations, detailed=full context",
+
+      "technical_depth": "balanced",
+      "_technical_depth_options": ["surface", "balanced", "deep", "expert"],
+      "_technical_depth_description": "Technical detail level - surface=simple explanations, balanced=moderate detail, expert=full technical depth"
+    },
+
+    "guidance": {
+      "_description": "Controls how much help and guidance agents provide based on your experience level",
+      "_used_in": [
+        "src/guidance/experience-manager.js:183,184",
+        "src/guidance/adaptive-guide.js:155,176,650"
+      ],
+      "experience_level": "adaptive",
+      "_experience_level_options": ["novice", "intermediate", "expert", "adaptive"],
+      "_experience_level_description": "Your skill level - novice=lots of guidance, expert=minimal help, adaptive=learns your patterns",
+
+      "show_advanced_options": false,
+      "_show_advanced_options_description": "Whether to show complex/dangerous options to prevent accidents",
+      "_show_advanced_options_used_in": ["src/cli/commands/ (controls advanced option visibility)"],
+
+      "progressive_disclosure": true,
+      "_progressive_disclosure_description": "Show simple options first, reveal advanced features as you grow",
+      "_progressive_disclosure_used_in": ["src/guidance/adaptive-guide.js (feature reveal logic)"],
+
+      "context_aware_help": true,
+      "_context_aware_help_description": "Provide help based on what you're currently working on",
+      "_context_aware_help_used_in": ["src/guidance/context-helper.js (contextual assistance)"]
+    },
+
+    "workflow": {
+      "_description": "Controls automatic optimization and learning from your work patterns",
+      "auto_optimize": true,
+      "_auto_optimize_description": "Let the system automatically improve workflows based on your usage patterns",
+
+      "suggestion_frequency": "after_major_tasks",
+      "_suggestion_frequency_options": ["never", "after_major_tasks", "frequently", "always"],
+      "_suggestion_frequency_description": "When to offer optimization suggestions - never=no suggestions, always=constant suggestions",
+
+      "analytics_driven": true,
+      "_analytics_driven_description": "Use analytics to make better decisions about agent coordination and task routing",
+
+      "pattern_learning": true,
+      "_pattern_learning_description": "Learn from your successful patterns to improve future task handling"
+    },
+
+    "languages": {
+      "_description": "Controls automatic language detection and setup for different programming languages",
+      "auto_detect": true,
+      "_auto_detect_description": "Automatically detect what programming language/framework you're using",
+
+      "preferred_languages": ["javascript", "typescript", "python"],
+      "_preferred_languages_description": "Languages to prioritize when multiple options are available",
+
+      "auto_setup_linting": true,
+      "_auto_setup_linting_description": "Automatically configure linting and formatting tools for detected languages",
+
+      "framework_detection": true,
+      "_framework_detection_description": "Detect specific frameworks (React, Django, etc.) for better assistance"
+    },
+
+    "team": {
+      "_description": "Controls team collaboration and preference sharing across multiple developers",
+      "share_preferences": false,
+      "_share_preferences_description": "Share your preferences with team members for consistency",
+
+      "sync_claude_md": true,
+      "_sync_claude_md_description": "Keep CLAUDE.md configuration files synchronized across team",
+
+      "collaborative_mode": false,
+      "_collaborative_mode_description": "Enable real-time collaboration features with other team members"
+    },
+
+    "resourceDelegation": {
+      "_description": "Controls how heavy/slow commands are distributed across agents to improve performance",
+      "_used_in": [
+        "src/resource-management/resource-coordinator.js:39-50",
+        "src/resource-management/cli.js",
+        "src/collaboration/team-sync.js"
+      ],
+      "mode": "adaptive",
+      "_mode_options": ["adaptive", "distributed", "single-delegate"],
+      "_mode_description": "Strategy for handling heavy commands - adaptive=smart choice, distributed=spread across agents, single-delegate=one agent handles all",
+
+      "heavyCommandThreshold": 5000,
+      "_heavyCommandThreshold_description": "Commands taking longer than this (milliseconds) are considered 'heavy' and get special handling",
+      "_heavyCommandThreshold_used_in": ["src/resource-management/resource-coordinator.js:42 (command classification)"],
+
+      "maxConcurrentHeavyCommands": 2,
+      "_maxConcurrentHeavyCommands_description": "Maximum heavy commands running simultaneously to prevent system overload",
+      "_maxConcurrentHeavyCommands_used_in": ["src/resource-management/resource-coordinator.js:43 (concurrency limiting)"],
+
+      "preferredDelegate": "auto",
+      "_preferredDelegate_options": ["auto", "performance-optimized", "memory-optimized", "specific-agent-name"],
+      "_preferredDelegate_description": "Which agent to prefer for heavy tasks - auto=best available, performance-optimized=fastest agent",
+      "_preferredDelegate_used_in": ["src/resource-management/resource-coordinator.js:44 (agent selection)"],
+
+      "resourceLimits": {
+        "_description": "System resource usage limits to prevent overloading your machine",
+        "cpu": 80,
+        "_cpu_description": "Maximum CPU usage percentage before throttling",
+        "memory": 75,
+        "_memory_description": "Maximum memory usage percentage before warnings",
+        "network": 90,
+        "_network_description": "Maximum network bandwidth usage percentage"
+      },
+
+      "commands": {
+        "_description": "Specific command patterns and how they should be handled",
+        "heavyCommands": [
+          "npm test",
+          "npm run test",
+          "jest",
+          "vitest",
+          "npm run build",
+          "tsc",
+          "webpack",
+          "vite build",
+          "cargo build",
+          "cargo test",
+          "go build",
+          "go test",
+          "python -m pytest",
+          "mvn test",
+          "gradle build",
+          "docker build"
+        ],
+        "_heavyCommands_description": "Commands that typically take a long time and should use resource delegation",
+
+        "delegationRules": {
+          "_description": "Specific rules for different types of commands",
+          "test": "single-delegate",
+          "_test_description": "Testing commands use single-delegate to avoid conflicts",
+          "build": "adaptive",
+          "_build_description": "Build commands use adaptive strategy for best performance",
+          "compile": "single-delegate",
+          "_compile_description": "Compilation uses single agent to avoid file conflicts",
+          "lint": "distributed",
+          "_lint_description": "Linting can be distributed since it's read-only"
+        }
+      }
+    }
+  },
+
+  "customizations": {
+    "_description": "Fine-tune agent behavior and system organization to match your preferences",
+
+    "message_filters": {
+      "_description": "Control what types of messages and language agents use",
+      "_used_in": [
+        "src/filters/tone-processors.js",
+        "src/hooks/enhanced/personalization-hooks.js"
+      ],
+      "remove_congratulatory": true,
+      "_remove_congratulatory_description": "Remove celebratory language like 'Great job!' to keep responses focused",
+      "_remove_congratulatory_used_in": ["src/filters/tone-processors.js (message filtering)"],
+
+      "simplify_technical_jargon": false,
+      "_simplify_technical_jargon_description": "Replace complex technical terms with simpler explanations",
+      "_simplify_technical_jargon_used_in": ["src/filters/tone-processors.js (jargon replacement)"],
+
+      "focus_on_actionable": true,
+      "_focus_on_actionable_description": "Emphasize what you need to do next rather than explanations of what was done",
+      "_focus_on_actionable_used_in": ["src/filters/content-filters.js (response structuring)"]
+    },
+
+    "file_organization": {
+      "_description": "Control how agents organize and create files in your project",
+      "_used_in": [
+        "src/filters/content-filters.js",
+        "config/hooks/pre-edit-security.cjs"
+      ],
+      "strict_directory_rules": true,
+      "_strict_directory_rules_description": "Enforce proper file organization (no files in root directory, proper folder structure)",
+      "_strict_directory_rules_used_in": ["config/hooks/pre-edit-security.cjs (directory enforcement)"],
+
+      "auto_categorize": true,
+      "_auto_categorize_description": "Automatically put files in appropriate directories (src/, tests/, docs/, etc.)",
+      "_auto_categorize_used_in": ["src/filters/content-filters.js (automatic file placement)"],
+
+      "prevent_root_clutter": true,
+      "_prevent_root_clutter_description": "Block agents from creating files in the root directory to keep it clean",
+      "_prevent_root_clutter_used_in": ["config/hooks/pre-edit-security.cjs (root directory protection)"]
+    },
+
+    "agent_behavior": {
+      "_description": "Control overall agent personality and response style",
+      "_used_in": [
+        "src/hooks/enhanced/personalization-hooks.js",
+        "src/cli/personalization-cli.js"
+      ],
+      "concise_reporting": true,
+      "_concise_reporting_description": "Keep agent reports brief and to-the-point",
+      "_concise_reporting_used_in": ["src/hooks/enhanced/personalization-hooks.js (response formatting)"],
+
+      "focus_on_results": true,
+      "_focus_on_results_description": "Emphasize what was accomplished rather than how it was done",
+      "_focus_on_results_used_in": ["src/filters/content-filters.js (result emphasis)"],
+
+      "minimize_process_descriptions": false,
+      "_minimize_process_descriptions_description": "Reduce explanations of internal processes and focus on user-relevant information",
+      "_minimize_process_descriptions_used_in": ["src/filters/tone-processors.js (process filtering)"]
+    }
+  }
+}