proagents 1.0.0

package/proagents/learning/adaptation.md

@@ -0,0 +1,305 @@
+# Learning Adaptation
+
+How ProAgents applies learned patterns to improve over time.
+
+---
+
+## Adaptation Types
+
+### 1. Automatic Corrections
+
+When the same correction is made 3+ times, apply automatically:
+
+```yaml
+auto_corrections:
+  threshold: 3  # Apply after 3 similar corrections
+
+  example:
+    pattern: "AI suggests Redux"
+    correction: "User chooses Zustand"
+    occurrences: 5
+    status: "auto_applied"
+    action: "Now suggests Zustand by default"
+```
+
+**Adaptation Flow:**
+```
+Correction 1: "Use Zustand, not Redux" → Noted
+Correction 2: "Use Zustand, not Redux" → Noted
+Correction 3: "Use Zustand, not Redux" → AUTO-APPLY ENABLED
+Future: AI automatically uses Zustand
+```
+
+---
+
+### 2. Checkpoint Optimization
+
+Learn which checkpoints user actually reviews:
+
+```yaml
+checkpoint_adaptation:
+  # If user skips checkpoint >80% of time
+  high_skip_rate:
+    action: "suggest_disable"
+    threshold: 0.8
+
+  # If user always reviews carefully
+  careful_review:
+    action: "keep_enabled"
+    indicators:
+      - "review_time > 2min"
+      - "makes_changes"
+
+  current_optimization:
+    after_requirements: "suggest_skip"  # 90% skip rate
+    after_design: "keep"                # Always reviewed
+    after_testing: "suggest_skip"       # 85% skip rate
+    before_deployment: "keep"           # Always reviewed
+```
+
+---
+
+### 3. Pattern Following
+
+Automatically follow established codebase patterns:
+
+```yaml
+pattern_adaptation:
+  # Component creation
+  when: "creating_component"
+  learned:
+    location: "src/components/{category}/"
+    structure: "folder-per-component"
+    includes:
+      - "{Name}.tsx"
+      - "{Name}.test.tsx"
+      - "index.ts"
+    style: "functional with memo"
+    props: "interface above component"
+
+  # Service creation
+  when: "creating_service"
+  learned:
+    location: "src/services/"
+    naming: "{name}Service.ts"
+    pattern: "object with methods"
+    includes_types: true
+```
+
+---
+
+### 4. Output Calibration
+
+Adjust output based on user preferences:
+
+```yaml
+output_adaptation:
+  verbosity:
+    learned: "moderate"
+    indicators:
+      - "user rarely reads long explanations"
+      - "prefers bullet points"
+      - "wants code more than prose"
+
+  code_style:
+    learned:
+      comments: "minimal"
+      type_annotations: "comprehensive"
+      error_handling: "always_include"
+
+  communication:
+    learned:
+      announce_decisions: true
+      explain_reasoning: "brief"
+      suggest_alternatives: false
+```
+
+---
+
+### 5. Decision Prediction
+
+Predict decisions based on history:
+
+```yaml
+decision_prediction:
+  # High confidence predictions
+  high_confidence:
+    - decision: "state_management"
+      prediction: "zustand"
+      confidence: 0.95
+      basis: "100% historical choice"
+
+    - decision: "styling"
+      prediction: "tailwind"
+      confidence: 0.92
+      basis: "used in all features"
+
+  # Medium confidence
+  medium_confidence:
+    - decision: "error_handling"
+      prediction: "error_boundary"
+      confidence: 0.70
+      basis: "used in 70% of components"
+
+  # Apply predictions
+  application:
+    high_confidence: "auto_apply"
+    medium_confidence: "suggest_with_note"
+    low_confidence: "present_options"
+```
+
+---
+
+## Adaptation Rules
+
+### Rule 1: Conservative Learning
+
+```yaml
+conservative_learning:
+  # Don't learn from one-off decisions
+  minimum_occurrences: 3
+
+  # Decay old patterns
+  pattern_decay:
+    after_days: 90
+    reduce_confidence_by: 0.1
+
+  # Allow override
+  user_can_override: true
+```
+
+### Rule 2: Context-Aware Application
+
+```yaml
+context_awareness:
+  # Different contexts may have different patterns
+  contexts:
+    - context: "component"
+      patterns: [...]
+    - context: "service"
+      patterns: [...]
+    - context: "api"
+      patterns: [...]
+
+  # Match context before applying
+  matching:
+    use_file_location: true
+    use_task_description: true
+    use_existing_imports: true
+```
+
+### Rule 3: Reversible Adaptations
+
+```yaml
+reversibility:
+  # All adaptations can be undone
+  undo_commands:
+    - "/learning-undo last"
+    - "/learning-undo [adaptation-id]"
+    - "/learning-disable [pattern]"
+
+  # Reset to defaults
+  reset:
+    - "/learning-reset"
+    - "Clears all learned patterns"
+    - "Returns to default behavior"
+```
+
+---
+
+## Adaptation Feedback Loop
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    Learning Feedback Loop                        │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   User Action → Collect Data → Analyze Pattern → Apply Learning │
+│        ↑                                              │         │
+│        │                                              ↓         │
+│        └──────────── Verify Outcome ←─────────────────┘         │
+│                                                                 │
+│   If outcome = positive → Reinforce pattern                    │
+│   If outcome = negative → Reduce confidence                    │
+│   If outcome = correction → Learn new pattern                  │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Adaptation Dashboard
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ Learning Adaptations - Active                                   │
+├─────────────────────────────────────────────────────────────────┤
+│ Auto-Applied Corrections: 12                                    │
+│ ├── State management: Zustand (5 corrections learned)          │
+│ ├── Component style: Functional (3 corrections learned)        │
+│ └── File naming: kebab-case (4 corrections learned)            │
+├─────────────────────────────────────────────────────────────────┤
+│ Checkpoint Optimizations:                                       │
+│ ├── after_requirements: Suggested skip (90% skip rate)         │
+│ └── after_design: Keep (always reviewed)                       │
+├─────────────────────────────────────────────────────────────────┤
+│ Pattern Following: 45 patterns learned                          │
+│ ├── Component patterns: 15                                     │
+│ ├── Service patterns: 10                                       │
+│ ├── Test patterns: 12                                          │
+│ └── Import patterns: 8                                         │
+├─────────────────────────────────────────────────────────────────┤
+│ Decision Predictions:                                           │
+│ ├── High confidence: 8                                         │
+│ ├── Medium confidence: 5                                       │
+│ └── Learning: 3                                                │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+
+learning:
+  adaptation:
+    # Enable auto-corrections
+    auto_corrections:
+      enabled: true
+      threshold: 3
+
+    # Checkpoint optimization
+    checkpoint_optimization:
+      enabled: true
+      suggest_disable_threshold: 0.8
+
+    # Pattern following
+    pattern_following:
+      enabled: true
+      min_confidence: 0.7
+
+    # Decision prediction
+    decision_prediction:
+      enabled: true
+      auto_apply_threshold: 0.9
+
+    # Safety
+    safety:
+      require_confirmation_for_new: false
+      allow_override: true
+      max_auto_corrections_per_session: 10
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/adaptation-status` | View current adaptations |
+| `/adaptation-disable [id]` | Disable specific adaptation |
+| `/adaptation-enable [id]` | Re-enable adaptation |
+| `/adaptation-reset` | Reset all adaptations |
+| `/adaptation-review` | Review pending adaptations |

package/proagents/learning/data-collection.md

@@ -0,0 +1,283 @@
+# Learning Data Collection
+
+What data ProAgents collects to improve over time.
+
+---
+
+## Overview
+
+ProAgents learns from your development patterns to provide better suggestions and reduce friction over time.
+
+---
+
+## Data Categories
+
+### 1. User Preferences
+
+**What's Collected:**
+```yaml
+preferences:
+  # Checkpoint preferences
+  checkpoints:
+    usually_skips: ["after_requirements", "after_testing"]
+    always_reviews: ["after_design", "before_deployment"]
+    skip_rate_by_phase:
+      analysis: 0.2
+      requirements: 0.8
+      design: 0.1
+
+  # Detail level
+  output_preferences:
+    verbosity: "moderate"  # concise | moderate | detailed
+    code_comments: "minimal"
+    documentation_depth: "moderate"
+
+  # Review patterns
+  review_behavior:
+    average_review_time: "5min"
+    usually_accepts_first_suggestion: true
+    common_modifications: ["naming", "structure"]
+```
+
+**How It's Used:**
+- Skip unnecessary checkpoints automatically
+- Adjust output verbosity
+- Pre-modify suggestions based on patterns
+
+---
+
+### 2. Correction History
+
+**What's Collected:**
+```yaml
+corrections:
+  - id: "corr_001"
+    timestamp: "2024-01-15T10:30:00Z"
+    original_suggestion: "Use Redux for state management"
+    user_correction: "Use Zustand instead"
+    context: "new_feature"
+    frequency: 3  # How many times this correction happened
+
+  - id: "corr_002"
+    timestamp: "2024-01-16T14:00:00Z"
+    original_suggestion: "Create class component"
+    user_correction: "Use functional component"
+    context: "component_creation"
+    frequency: 5
+```
+
+**How It's Used:**
+- After 3 similar corrections → Auto-apply
+- Prevent repeated mistakes
+- Learn user's preferred approaches
+
+---
+
+### 3. Project Patterns
+
+**What's Collected:**
+```yaml
+project_patterns:
+  # File structure
+  structure:
+    components_location: "src/components/"
+    services_location: "src/services/"
+    hooks_location: "src/hooks/"
+    pattern_confidence: 0.95
+
+  # Naming conventions
+  naming:
+    components: "PascalCase"
+    hooks: "useCamelCase"
+    services: "camelCaseService"
+    files:
+      components: "PascalCase.tsx"
+      utilities: "camelCase.ts"
+    pattern_confidence: 0.92
+
+  # Code patterns
+  code_style:
+    component_style: "functional"
+    state_management: "zustand"
+    data_fetching: "react-query"
+    styling: "tailwind"
+    pattern_confidence: 0.98
+
+  # Import patterns
+  imports:
+    style: "named"
+    order: ["react", "third-party", "local", "styles"]
+    use_aliases: true
+    alias_prefix: "@/"
+```
+
+**How It's Used:**
+- Generate code matching existing patterns
+- Place files in correct locations
+- Follow established conventions
+
+---
+
+### 4. Decision History
+
+**What's Collected:**
+```yaml
+decisions:
+  - decision_id: "dec_001"
+    type: "architecture"
+    question: "API style selection"
+    chosen: "rest"
+    alternatives: ["graphql", "grpc"]
+    context: "user_service"
+    outcome: "successful"  # successful | needed_revision | failed
+
+  - decision_id: "dec_002"
+    type: "implementation"
+    question: "Error handling approach"
+    chosen: "error-boundary"
+    alternatives: ["try-catch", "result-type"]
+    context: "component"
+    outcome: "successful"
+```
+
+**How It's Used:**
+- Recommend previously successful decisions
+- Avoid approaches that needed revision
+- Build decision confidence scores
+
+---
+
+### 5. Time Metrics
+
+**What's Collected:**
+```yaml
+time_metrics:
+  # Phase durations
+  phases:
+    analysis:
+      average: "15min"
+      min: "5min"
+      max: "45min"
+    implementation:
+      average: "2hrs"
+      min: "30min"
+      max: "8hrs"
+
+  # Feature completion
+  features:
+    average_completion: "4hrs"
+    by_complexity:
+      simple: "1hr"
+      medium: "3hrs"
+      complex: "8hrs"
+
+  # Review times
+  review:
+    average_checkpoint_review: "5min"
+    pr_review_time: "30min"
+```
+
+**How It's Used:**
+- Better task estimation
+- Identify bottleneck phases
+- Optimize workflow suggestions
+
+---
+
+### 6. Error Patterns
+
+**What's Collected:**
+```yaml
+errors:
+  # Common errors
+  - pattern: "import_path_error"
+    frequency: 12
+    usual_cause: "wrong_alias"
+    usual_fix: "use @/ prefix"
+
+  - pattern: "type_mismatch"
+    frequency: 8
+    usual_cause: "optional_property"
+    usual_fix: "add undefined check"
+
+  # Build failures
+  build_failures:
+    - type: "typescript_error"
+      frequency: 5
+      common_fixes: ["add_types", "fix_imports"]
+
+    - type: "test_failure"
+      frequency: 3
+      common_fixes: ["update_mocks", "fix_assertions"]
+```
+
+**How It's Used:**
+- Proactively prevent common errors
+- Suggest fixes based on history
+- Improve code generation accuracy
+
+---
+
+## Storage Structure
+
+```
+.proagents/learning/
+├── global/                      # Cross-project learnings
+│   ├── user-preferences.json
+│   └── common-corrections.json
+│
+└── projects/
+    └── [project-hash]/
+        ├── patterns.json        # Project-specific patterns
+        ├── decisions.json       # Decision history
+        ├── corrections.json     # Corrections in this project
+        ├── metrics.json         # Time and performance metrics
+        └── errors.json          # Error patterns
+```
+
+---
+
+## Privacy & Data Control
+
+### What's NOT Collected
+- Source code content
+- Credentials or secrets
+- Personal identifiable information
+- Third-party API keys
+
+### Data Stays Local
+```yaml
+privacy:
+  data_location: "local"  # All data stays on your machine
+  share_anonymized: false  # No cloud sharing by default
+  retention: "project_lifetime"
+```
+
+### User Controls
+```yaml
+learning:
+  # Enable/disable specific tracking
+  track_preferences: true
+  track_patterns: true
+  track_corrections: true
+  track_metrics: true
+  track_errors: true
+
+  # Reset options
+  reset_commands:
+    - "/learning-reset all"      # Reset everything
+    - "/learning-reset project"  # Reset current project
+    - "/learning-reset patterns" # Reset patterns only
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/learning-status` | Show learning statistics |
+| `/learning-patterns` | View learned patterns |
+| `/learning-corrections` | View correction history |
+| `/learning-reset` | Reset learning data |
+| `/learning-export` | Export learning data |