proagents 1.0.0

package/proagents/workflow-modes/mode-detection.md

@@ -0,0 +1,358 @@
+# Mode Detection
+
+Automatic detection of the appropriate workflow mode based on user input.
+
+---
+
+## Overview
+
+ProAgents analyzes user requests to suggest the most appropriate workflow mode:
+
+```
+User Input → Analysis → Mode Suggestion → User Confirmation
+```
+
+---
+
+## Detection Logic
+
+### Input Analysis
+
+```yaml
+detection_process:
+  step_1_keyword_analysis:
+    bug_fix_keywords:
+      - "fix"
+      - "bug"
+      - "broken"
+      - "not working"
+      - "issue"
+      - "error"
+      - "crash"
+      - "failing"
+
+    quick_change_keywords:
+      - "update"
+      - "change"
+      - "config"
+      - "url"
+      - "typo"
+      - "text"
+      - "rename"
+
+    full_workflow_keywords:
+      - "add"
+      - "implement"
+      - "create"
+      - "build"
+      - "feature"
+      - "refactor"
+      - "redesign"
+
+  step_2_complexity_analysis:
+    simple:
+      - "single file change"
+      - "configuration only"
+      - "text change"
+
+    moderate:
+      - "specific bug fix"
+      - "isolated change"
+      - "clear scope"
+
+    complex:
+      - "new functionality"
+      - "multiple components"
+      - "architectural impact"
+
+  step_3_impact_analysis:
+    low_impact:
+      - "documentation"
+      - "styling"
+      - "config"
+
+    medium_impact:
+      - "business logic"
+      - "UI components"
+      - "api calls"
+
+    high_impact:
+      - "authentication"
+      - "payment"
+      - "database"
+      - "security"
+```
+
+---
+
+## Detection Examples
+
+### Bug Fix Detection
+
+```
+User: "The login button doesn't work on mobile devices"
+
+Analysis:
+├── Keywords: "doesn't work" → bug indicator
+├── Scope: Single component (login button)
+├── Impact: Medium (auth-related but UI only)
+└── Confidence: 92%
+
+Suggestion: Bug Fix Mode
+```
+
+### Quick Change Detection
+
+```
+User: "Update the API URL from staging to production"
+
+Analysis:
+├── Keywords: "update", "URL" → config change
+├── Scope: Configuration file
+├── Impact: Low (config only)
+└── Confidence: 95%
+
+Suggestion: Quick Change Mode
+```
+
+### Full Workflow Detection
+
+```
+User: "Add user profile management with avatar upload"
+
+Analysis:
+├── Keywords: "add", "feature" → new functionality
+├── Scope: Multiple components, storage, API
+├── Impact: High (new feature)
+└── Confidence: 98%
+
+Suggestion: Full Workflow Mode
+```
+
+---
+
+## Detection Patterns
+
+### Pattern Matching Rules
+
+```yaml
+detection_patterns:
+  # Bug Fix patterns
+  bug_fix:
+    - pattern: "(fix|resolve|repair) .+ (bug|issue|error)"
+      confidence: 0.95
+
+    - pattern: ".+ (not working|broken|failing)"
+      confidence: 0.90
+
+    - pattern: "(crash|error|exception) .+"
+      confidence: 0.85
+
+    - pattern: "why (is|does) .+ (not|fail)"
+      confidence: 0.80
+
+  # Quick Change patterns
+  quick_change:
+    - pattern: "(update|change|modify) .+ (config|url|endpoint)"
+      confidence: 0.95
+
+    - pattern: "fix typo in .+"
+      confidence: 0.95
+
+    - pattern: "(rename|replace) .+ to .+"
+      confidence: 0.85
+      condition: "single_file"
+
+    - pattern: "change .+ text"
+      confidence: 0.90
+
+  # Full Workflow patterns
+  full_workflow:
+    - pattern: "(add|implement|create|build) .+ (feature|functionality)"
+      confidence: 0.95
+
+    - pattern: "(refactor|redesign|rewrite) .+"
+      confidence: 0.90
+
+    - pattern: "integrate .+ with .+"
+      confidence: 0.85
+
+    - pattern: "(new|complete) .+ system"
+      confidence: 0.95
+```
+
+---
+
+## AI-Assisted Detection
+
+When pattern matching isn't conclusive, AI analysis is used:
+
+```yaml
+ai_detection:
+  enabled: true
+  use_when: "confidence < 0.8"
+
+  analysis_prompt: |
+    Analyze this development request and determine the appropriate
+    workflow mode:
+
+    Request: "{user_request}"
+
+    Modes:
+    1. Full Workflow - For new features, major changes
+    2. Bug Fix - For fixing issues, errors
+    3. Quick Change - For config updates, typos
+
+    Consider:
+    - Scope of change
+    - Complexity
+    - Risk level
+    - Number of files likely affected
+
+    Respond with: mode, confidence, reasoning
+```
+
+---
+
+## Context-Aware Detection
+
+### File Context
+
+```yaml
+file_context_hints:
+  # If user mentions specific files
+  config_files:
+    patterns: ["*.config.*", "*.env*", "config/*"]
+    suggests: "quick_change"
+    confidence_boost: 0.15
+
+  test_files:
+    patterns: ["*.test.*", "*.spec.*", "__tests__/*"]
+    suggests: "bug_fix"
+    confidence_boost: 0.10
+
+  component_files:
+    patterns: ["*/components/*", "*.tsx"]
+    suggests: "varies"
+    check_keywords: true
+```
+
+### Git Context
+
+```yaml
+git_context_hints:
+  # Current branch type
+  branch_hints:
+    - pattern: "fix/*"
+      suggests: "bug_fix"
+
+    - pattern: "hotfix/*"
+      suggests: "quick_change"
+
+    - pattern: "feature/*"
+      suggests: "full_workflow"
+
+  # Recent activity
+  recent_commits:
+    check_for: "related changes"
+    suggests: "resume if found"
+```
+
+### Project Context
+
+```yaml
+project_context:
+  # Area being modified
+  critical_paths:
+    - "src/auth/**"
+    - "src/payment/**"
+    - "src/security/**"
+    action: "require_full_workflow_or_careful_review"
+
+  # Low risk areas
+  safe_paths:
+    - "docs/**"
+    - "README.md"
+    - "*.config.js"
+    action: "allow_quick_change"
+```
+
+---
+
+## User Confirmation
+
+After detection, confirm with user:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Mode Detection                                              │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│ Request: "Fix the login button not responding"              │
+│                                                             │
+│ Detected Mode: Bug Fix (Fast Track)                        │
+│ Confidence: 92%                                             │
+│                                                             │
+│ Reasoning:                                                  │
+│ • Contains "fix" keyword                                   │
+│ • Describes specific issue                                  │
+│ • Scope appears limited                                     │
+│                                                             │
+│ [Start Bug Fix] [Use Full Workflow] [Quick Change]         │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Override Detection
+
+Users can always override:
+
+```bash
+# Force full workflow
+/feature start "Fix login button" --mode full
+
+# Force bug fix mode
+/fix "Add new validation" --mode bug-fix
+
+# Skip detection
+/quick "Update config" --no-detect
+```
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+
+mode_detection:
+  enabled: true
+  confidence_threshold: 0.75
+
+  # When to ask user
+  ask_user:
+    when_confidence_below: 0.80
+    always_for: ["critical_paths"]
+    never_for: ["quick_changes"]
+
+  # AI assistance
+  ai_assist:
+    enabled: true
+    model: "fast"  # Use fast model for detection
+
+  # Learning
+  learn_from_choices: true
+  adapt_to_user: true
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/detect [request]` | Test mode detection |
+| `/mode suggest` | Get mode suggestion for current context |
+| `/mode override [mode]` | Override detected mode |

package/proagents/workflow-modes/mode-switching.md

@@ -0,0 +1,372 @@
+# Mode Switching
+
+Switch between workflow modes during development.
+
+---
+
+## Overview
+
+Sometimes you need to change modes mid-workflow:
+- Bug fix turns out to be more complex
+- Feature is simpler than expected
+- Requirements change during development
+
+---
+
+## Switching Scenarios
+
+### Upgrade: Bug Fix → Full Workflow
+
+```
+Started: Bug Fix Mode
+Reason: "Fix login button"
+
+During work:
+├── Discovered: Issue requires auth flow redesign
+├── Scope: Multiple components affected
+├── Complexity: Higher than expected
+└── Trigger: touches_security_code = true
+
+Action: Suggest upgrade to Full Workflow
+```
+
+**How to Switch:**
+```bash
+# Manual switch
+/mode switch full-workflow
+
+# Accept suggestion
+# When prompted: [Upgrade to Full Workflow?] → Yes
+```
+
+**What Happens:**
+```yaml
+upgrade_process:
+  preserve:
+    - "Current code changes"
+    - "Context gathered"
+    - "Files identified"
+
+  add:
+    - "Analysis phase (quick version)"
+    - "Requirements documentation"
+    - "Implementation planning"
+    - "Full testing requirements"
+
+  update:
+    - "Feature tracking to full workflow"
+    - "Checklist expanded"
+```
+
+---
+
+### Downgrade: Full Workflow → Bug Fix
+
+```
+Started: Full Workflow
+Reason: "Implement user preferences"
+
+During work:
+├── Analysis revealed: Simple feature
+├── Scope: Single component
+├── No design needed
+└── Can be done quickly
+
+Action: Suggest downgrade to Bug Fix
+```
+
+**How to Switch:**
+```bash
+# Manual switch
+/mode switch bug-fix
+
+# With confirmation
+/mode switch bug-fix --confirm
+```
+
+**What Happens:**
+```yaml
+downgrade_process:
+  preserve:
+    - "Requirements gathered"
+    - "Files identified"
+    - "Context"
+
+  skip:
+    - "Full analysis (use quick scan)"
+    - "Design phase"
+    - "Extensive planning"
+
+  still_require:
+    - "Testing"
+    - "Basic documentation"
+    - "Code review"
+```
+
+---
+
+### Quick Change → Bug Fix
+
+```
+Started: Quick Change
+Reason: "Update API URL"
+
+During work:
+├── Found: URL change breaks functionality
+├── Need: Additional code changes
+└── Scope: Expanded
+
+Action: Auto-upgrade to Bug Fix
+```
+
+---
+
+## Automatic Mode Switching
+
+### Auto-Upgrade Triggers
+
+```yaml
+auto_upgrade_triggers:
+  # Bug Fix → Full Workflow
+  bug_fix_to_full:
+    conditions:
+      - files_changed: "> 5"
+      - duration: "> 3 hours"
+      - touches:
+          - "authentication"
+          - "payment"
+          - "database schema"
+      - requires:
+          - "new_api_endpoints"
+          - "database_migration"
+          - "ui_redesign"
+
+    action: "suggest_upgrade"
+    blocking: false
+
+  # Quick Change → Bug Fix
+  quick_to_bug_fix:
+    conditions:
+      - files_changed: "> 1"
+      - code_logic_changed: true
+      - tests_needed: true
+
+    action: "auto_upgrade"
+    blocking: false
+
+  # Quick Change → Full Workflow
+  quick_to_full:
+    conditions:
+      - complexity: "high"
+      - multiple_features: true
+
+    action: "suggest_upgrade"
+    blocking: true
+```
+
+### Auto-Downgrade Suggestions
+
+```yaml
+auto_downgrade_suggestions:
+  # Full Workflow → Bug Fix
+  full_to_bug_fix:
+    conditions:
+      - analysis_shows: "simple_change"
+      - files_affected: "< 3"
+      - no_design_needed: true
+      - time_estimate: "< 2 hours"
+
+    action: "suggest_downgrade"
+    user_choice: true
+
+  # Full Workflow → Quick Change
+  full_to_quick:
+    conditions:
+      - only_config_change: true
+      - no_code_logic: true
+      - single_file: true
+
+    action: "suggest_downgrade"
+    user_choice: true
+```
+
+---
+
+## Switch Flow
+
+### Step-by-Step Process
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Mode Switch Process                       │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  1. Trigger Detection                                       │
+│     └── Manual request OR Auto-detected condition           │
+│                                                             │
+│  2. State Preservation                                      │
+│     ├── Save current progress                               │
+│     ├── Save gathered context                               │
+│     └── Save any code changes                               │
+│                                                             │
+│  3. Mode Transition                                         │
+│     ├── Update workflow mode                                │
+│     ├── Recalculate phases                                  │
+│     └── Update requirements                                 │
+│                                                             │
+│  4. Context Adaptation                                      │
+│     ├── Add/remove phases as needed                         │
+│     ├── Adjust checkpoints                                  │
+│     └── Update documentation requirements                   │
+│                                                             │
+│  5. Continue Work                                           │
+│     └── Resume from appropriate phase                       │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## State Preservation
+
+### What Gets Preserved
+
+```yaml
+preserved_on_switch:
+  always:
+    - "code_changes"          # Any code written
+    - "gathered_context"       # Codebase analysis
+    - "identified_files"       # Files to modify
+    - "user_decisions"         # Choices made
+    - "time_spent"            # Tracking data
+
+  upgrade_only:
+    - "quick_analysis"         # Becomes input for full analysis
+    - "fix_description"        # Becomes requirements input
+
+  downgrade_only:
+    - "full_analysis"          # Kept for reference
+    - "requirements"           # Simplified but kept
+```
+
+### State File
+
+```json
+{
+  "switch_event": {
+    "from_mode": "bug_fix",
+    "to_mode": "full_workflow",
+    "timestamp": "2024-01-15T10:30:00Z",
+    "reason": "Scope expanded beyond bug fix",
+    "trigger": "manual"
+  },
+  "preserved_state": {
+    "original_request": "Fix login button",
+    "files_identified": ["src/auth/LoginForm.tsx"],
+    "context_gathered": { },
+    "code_changes": { },
+    "time_spent_minutes": 45
+  },
+  "new_requirements": {
+    "additional_phases": ["analysis", "design", "planning"],
+    "new_checkpoints": ["after_design"],
+    "expanded_testing": true
+  }
+}
+```
+
+---
+
+## User Interface
+
+### Switch Prompt
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Mode Switch Detected                                        │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│ Current Mode: Bug Fix                                       │
+│ Suggested Mode: Full Workflow                               │
+│                                                             │
+│ Reason: Change touches authentication code and requires     │
+│ database modifications.                                      │
+│                                                             │
+│ What will change:                                           │
+│ + Full codebase analysis                                    │
+│ + Design phase added                                        │
+│ + Implementation planning                                   │
+│ + Comprehensive testing                                     │
+│ + Full documentation                                        │
+│                                                             │
+│ What stays the same:                                        │
+│ ✓ Your current code changes                                │
+│ ✓ Context gathered so far                                  │
+│ ✓ Files identified                                         │
+│                                                             │
+│ [Switch to Full Workflow] [Stay in Bug Fix] [Ask Me Later] │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Commands
+
+```bash
+# Switch modes
+/mode switch full-workflow
+/mode switch bug-fix
+/mode switch quick-change
+
+# Check current mode
+/mode current
+
+# See switch history
+/mode history
+
+# Force mode (skip confirmation)
+/mode switch full-workflow --force
+```
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+
+mode_switching:
+  enabled: true
+
+  auto_upgrade:
+    enabled: true
+    triggers:
+      - "files_exceed_threshold"
+      - "touches_critical_code"
+      - "duration_exceeded"
+    require_confirmation: true
+
+  auto_downgrade:
+    enabled: true
+    suggest_only: true  # Never auto-downgrade
+
+  preserve_state:
+    code_changes: true
+    context: true
+    time_tracking: true
+
+  notifications:
+    on_switch: true
+    on_suggestion: true
+```
+
+---
+
+## Best Practices
+
+1. **Don't resist upgrades** - If the system suggests upgrading, it's usually right
+2. **Preserve your work** - Switching always keeps your code changes
+3. **Document the switch** - Note why mode was changed for future reference
+4. **Complete current task** - Finish current subtask before switching if possible
+5. **Review new requirements** - After upgrading, review what's now expected