claude-flow-novice 1.2.1 → 1.3.1

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)"]
+    }
+  }
+}