proagents 1.0.0

package/proagents/metrics/learning-effectiveness.md

@@ -0,0 +1,478 @@
+# Learning Effectiveness Metrics
+
+Track workflow adoption, improvement rates, and optimization effectiveness.
+
+---
+
+## Prompt Template
+
+```
+Analyze learning system effectiveness for this project:
+
+Project: {project_name}
+Period: {date_range}
+Usage Data: {learning_data}
+
+Evaluate:
+1. Workflow adoption rate
+2. Pattern learning accuracy
+3. Suggestion acceptance rate
+4. Time savings achieved
+5. Error reduction rate
+
+Compare:
+- Initial baseline: {baseline}
+- Current performance: {current}
+- Target improvements: {targets}
+
+Provide:
+- Learning system effectiveness score
+- Key improvements made
+- Areas still learning
+- Recommendations for optimization
+```
+
+---
+
+## Key Metrics
+
+### Workflow Adoption
+
+Track how effectively the team adopts ProAgents workflows.
+
+```yaml
+adoption:
+  metrics:
+    active_users: "Users using workflow regularly"
+    feature_utilization: "Features being used"
+    workflow_completion: "Workflows completed vs started"
+    checkpoint_usage: "Custom checkpoint configurations"
+
+  targets:
+    active_user_rate: "> 80%"
+    feature_utilization: "> 60%"
+    workflow_completion: "> 90%"
+```
+
+**Tracking:**
+```typescript
+interface AdoptionMetrics {
+  activeUsers: {
+    total: number;
+    percentage: number;
+    trend: 'growing' | 'stable' | 'declining';
+  };
+  featureUtilization: Map<string, {
+    users: number;
+    frequency: number;
+    satisfaction: number;
+  }>;
+  workflowCompletion: {
+    started: number;
+    completed: number;
+    abandoned: number;
+    rate: number;
+  };
+}
+```
+
+**Dashboard:**
+```
+Workflow Adoption - Last 30 Days
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Active Users: 12/15 (80%) ✅
+Trend: ↑ Growing (+2 this month)
+
+Feature Utilization:
+Full Workflow:     ████████░░ 78%
+Bug Fix Mode:      ██████████ 95%
+Quick Change:      ███████░░░ 68%
+Code Review:       █████████░ 88%
+Documentation:     ██████░░░░ 55%
+
+Workflow Completion:
+Started:    156
+Completed:  142
+Abandoned:   14
+Rate: 91% ✅
+
+Abandonment Reasons:
+- Requirements changed: 8
+- Switched to quick mode: 4
+- Other: 2
+```
+
+---
+
+### Pattern Learning Accuracy
+
+How accurately the system learns project patterns.
+
+```yaml
+pattern_learning:
+  categories:
+    naming_conventions: "Variable, function, file naming"
+    code_style: "Formatting, structure preferences"
+    architecture: "Module organization, patterns used"
+    testing: "Test structure, assertion styles"
+
+  measurement:
+    accuracy: "Correct suggestions / total suggestions"
+    confidence: "System confidence in patterns"
+    coverage: "Patterns detected / total patterns"
+```
+
+**Analysis:**
+```typescript
+interface PatternLearningMetrics {
+  overallAccuracy: number;
+  byCategory: {
+    namingConventions: { accuracy: number; coverage: number; examples: number };
+    codeStyle: { accuracy: number; coverage: number; examples: number };
+    architecture: { accuracy: number; coverage: number; examples: number };
+    testing: { accuracy: number; coverage: number; examples: number };
+  };
+  recentLearnings: PatternLearning[];
+  needsMoreData: string[];
+}
+
+interface PatternLearning {
+  pattern: string;
+  confidence: number;
+  examples: number;
+  lastUsed: Date;
+}
+```
+
+**Report:**
+```
+Pattern Learning Accuracy
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Overall Accuracy: 87%
+
+By Category:
+Naming Conventions:  ████████░░ 92% (high confidence)
+Code Style:          █████████░ 89% (high confidence)
+Architecture:        ████████░░ 85% (medium confidence)
+Testing Patterns:    ███████░░░ 78% (learning)
+
+Recently Learned:
+✓ Component naming: use{Feature}Hook pattern
+✓ API calls: always use try-catch wrapper
+✓ Tests: describe → it → expect structure
+✓ Imports: group by external → internal → styles
+
+Still Learning (need more examples):
+• State management patterns (5 examples)
+• Error handling preferences (8 examples)
+• Database query patterns (3 examples)
+```
+
+---
+
+### Suggestion Acceptance Rate
+
+Track how often AI suggestions are accepted.
+
+```yaml
+suggestions:
+  types:
+    code_generation: "Generated code accepted"
+    refactoring: "Refactoring suggestions accepted"
+    fixes: "Bug fix suggestions accepted"
+    documentation: "Doc suggestions accepted"
+
+  tracking:
+    accepted: "Used as-is or with minor edits"
+    modified: "Significantly modified before use"
+    rejected: "Not used"
+```
+
+**Metrics:**
+```typescript
+interface SuggestionMetrics {
+  overallAcceptance: number;
+  byType: {
+    codeGeneration: { accepted: number; modified: number; rejected: number };
+    refactoring: { accepted: number; modified: number; rejected: number };
+    fixes: { accepted: number; modified: number; rejected: number };
+    documentation: { accepted: number; modified: number; rejected: number };
+  };
+  trend: 'improving' | 'stable' | 'declining';
+  commonRejectionReasons: Map<string, number>;
+}
+```
+
+**Dashboard:**
+```
+Suggestion Acceptance - Last 30 Days
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Overall Rate: 74% accepted, 18% modified, 8% rejected
+
+By Type:              Accepted  Modified  Rejected
+Code Generation       ████████░░ 78%   15%      7%
+Bug Fixes            █████████░ 85%   10%      5%
+Refactoring          ██████░░░░ 62%   25%     13%
+Documentation        ███████░░░ 71%   20%      9%
+
+Trend: ↑ Improving (+8% vs previous month)
+
+Common Rejection Reasons:
+1. Different style preference (35%)
+2. Over-engineered solution (28%)
+3. Missing edge case (20%)
+4. Performance concerns (12%)
+5. Other (5%)
+
+Learning Applied:
+• Now suggests simpler solutions
+• Better edge case handling
+• Aligned with team's style guide
+```
+
+---
+
+### Time Savings
+
+Measure time saved through workflow automation.
+
+```yaml
+time_savings:
+  baseline:
+    feature_development: "Manual average time"
+    bug_fixing: "Manual average time"
+    code_review: "Manual average time"
+    documentation: "Manual average time"
+
+  measurement:
+    actual_time: "Time with workflow"
+    estimated_manual: "Estimated without workflow"
+    savings: "estimated_manual - actual_time"
+```
+
+**Tracking:**
+```typescript
+interface TimeSavings {
+  totalSaved: Duration;
+  byActivity: {
+    codebaseAnalysis: { saved: Duration; percentage: number };
+    codeGeneration: { saved: Duration; percentage: number };
+    testing: { saved: Duration; percentage: number };
+    codeReview: { saved: Duration; percentage: number };
+    documentation: { saved: Duration; percentage: number };
+  };
+  weeklyTrend: Duration[];
+  projectedAnnualSavings: Duration;
+}
+```
+
+**Report:**
+```
+Time Savings Analysis - Last 30 Days
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Total Time Saved: 48.5 hours
+
+By Activity:
+Codebase Analysis:   ████████░░ 12h (45% reduction)
+Code Generation:     ██████████ 15h (55% reduction)
+Testing Setup:       ███████░░░  8h (35% reduction)
+Code Review:         █████░░░░░  6h (25% reduction)
+Documentation:       ███████░░░ 7.5h (40% reduction)
+
+Weekly Trend:
+Week 1:  ████████░░░░ 10h
+Week 2:  ██████████░░ 12h
+Week 3:  ███████████░ 13h
+Week 4:  ███████████░ 13.5h
+
+Projected Annual Savings: 582 hours
+At $100/hr: $58,200 value
+```
+
+---
+
+### Error Reduction
+
+Track reduction in errors and rework.
+
+```yaml
+error_reduction:
+  types:
+    code_errors: "Bugs introduced"
+    style_violations: "Linting/style issues"
+    test_failures: "Tests failing on first run"
+    deployment_issues: "Deployment problems"
+
+  comparison:
+    baseline_period: "Before workflow adoption"
+    current_period: "With workflow"
+```
+
+**Analysis:**
+```typescript
+interface ErrorReduction {
+  overallReduction: number;
+  byType: {
+    codeErrors: { baseline: number; current: number; reduction: number };
+    styleViolations: { baseline: number; current: number; reduction: number };
+    testFailures: { baseline: number; current: number; reduction: number };
+    deploymentIssues: { baseline: number; current: number; reduction: number };
+  };
+  reworkReduction: {
+    reviewCycles: { before: number; after: number };
+    bugFixRework: { before: number; after: number };
+  };
+}
+```
+
+**Dashboard:**
+```
+Error Reduction Analysis
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Overall Error Reduction: 42%
+
+By Type:            Before    After    Reduction
+Code Errors         8.2/week  4.1/week   -50%
+Style Violations    25/week   5/week     -80%
+Test Failures       12/week   6/week     -50%
+Deploy Issues       3/month   1/month    -67%
+
+Rework Reduction:
+Review Cycles:      2.8 avg → 1.6 avg    -43%
+Bug Fix Rework:     1.5/bug → 0.8/bug    -47%
+
+Key Improvements:
+✓ Auto-linting catches style issues
+✓ Pattern learning prevents common bugs
+✓ Pre-commit checks catch test failures
+✓ Deployment checklists reduce issues
+```
+
+---
+
+## Learning System Performance
+
+### Composite Learning Score
+
+```typescript
+interface LearningScore {
+  overall: number;  // 0-100
+  breakdown: {
+    adoption: { score: number; weight: 0.20 };
+    patternAccuracy: { score: number; weight: 0.25 };
+    suggestionAcceptance: { score: number; weight: 0.25 };
+    timeSavings: { score: number; weight: 0.15 };
+    errorReduction: { score: number; weight: 0.15 };
+  };
+  trend: 'improving' | 'stable' | 'declining';
+  maturityLevel: 'initial' | 'developing' | 'established' | 'optimized';
+}
+```
+
+**Dashboard:**
+```
+Learning System Effectiveness
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Overall Score: 76/100
+Maturity Level: ESTABLISHED
+
+Breakdown:
+Adoption (20%):          ████████░░ 80/100
+Pattern Accuracy (25%):  █████████░ 87/100
+Suggestion Accept (25%): ███████░░░ 74/100
+Time Savings (15%):      ███████░░░ 65/100
+Error Reduction (15%):   ███████░░░ 70/100
+
+Trend: ↑ Improving (+12 pts this quarter)
+
+Recommendations:
+1. More examples needed for testing patterns
+2. Simplify refactoring suggestions
+3. Add more project-specific terminology
+```
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+metrics:
+  learning:
+    enabled: true
+
+    tracking:
+      adoption: true
+      patterns: true
+      suggestions: true
+      time_savings: true
+      errors: true
+
+    baseline:
+      period: "2024-01-01 to 2024-01-31"
+      source: "historical_data"
+
+    reporting:
+      schedule: "monthly"
+      include_recommendations: true
+
+    privacy:
+      anonymize: true
+      no_code_samples: true
+```
+
+---
+
+## Commands
+
+```bash
+# View learning dashboard
+/metrics learning
+
+# Adoption analysis
+/metrics learning --adoption
+
+# Pattern accuracy
+/metrics learning --patterns
+
+# Suggestion stats
+/metrics learning --suggestions
+
+# Time savings report
+/metrics learning --savings
+
+# Generate learning report
+/metrics learning --report
+```
+
+---
+
+## Improving Learning Effectiveness
+
+### Increasing Adoption
+
+1. **Onboarding**: Provide workflow tutorials
+2. **Quick Wins**: Start with bug fix mode
+3. **Champions**: Identify power users
+4. **Feedback**: Act on user feedback
+
+### Improving Pattern Learning
+
+1. **Consistent Code**: Follow established patterns
+2. **Examples**: Provide more training examples
+3. **Corrections**: Correct AI mistakes promptly
+4. **Documentation**: Document patterns explicitly
+
+### Increasing Suggestion Acceptance
+
+1. **Simpler Solutions**: Prefer straightforward code
+2. **Style Alignment**: Match team preferences
+3. **Context Awareness**: Consider project context
+4. **Iteration**: Learn from rejections
+
+### Maximizing Time Savings
+
+1. **Full Workflow**: Use all phases consistently
+2. **Automation**: Automate repetitive tasks
+3. **Templates**: Create project-specific templates
+4. **Shortcuts**: Learn and use quick commands

package/proagents/migrations/README.md

@@ -0,0 +1,77 @@
+# Migration Guides
+
+Migrate from other tools and workflows to ProAgents.
+
+---
+
+## Available Migrations
+
+| From | Guide | Difficulty |
+|------|-------|------------|
+| Cursor Rules | [cursor-rules.md](./from-cursor-rules.md) | Easy |
+| Claude Projects | [claude-projects.md](./from-claude-projects.md) | Easy |
+| GitHub Copilot | [github-copilot.md](./from-github-copilot.md) | Easy |
+| Custom Workflows | [custom-workflows.md](./from-custom-workflows.md) | Medium |
+
+---
+
+## Quick Migration
+
+### Automated Migration
+
+```bash
+# Detect and migrate from existing setup
+proagents migrate --detect
+
+# Migrate from specific tool
+proagents migrate --from cursor-rules
+proagents migrate --from claude-projects
+
+# Preview migration without applying
+proagents migrate --from cursor-rules --dry-run
+```
+
+### Manual Migration
+
+1. Install ProAgents
+2. Run `proagents init`
+3. Import existing configurations
+4. Verify and adjust settings
+
+---
+
+## What Gets Migrated
+
+| Source | Migrated To |
+|--------|-------------|
+| Cursor `.cursorrules` | ProAgents standards + IDE rules |
+| Claude Project Instructions | ProAgents prompts + standards |
+| Copilot Instructions | ProAgents standards + IDE rules |
+| Custom Rules | ProAgents rules engine |
+| Code Conventions | ProAgents standards |
+
+---
+
+## Migration Checklist
+
+- [ ] Backup existing configuration
+- [ ] Run migration in dry-run mode first
+- [ ] Review generated ProAgents config
+- [ ] Test with a small feature
+- [ ] Update team documentation
+- [ ] Remove old configuration (optional)
+
+---
+
+## Getting Help
+
+```bash
+# Show migration help
+proagents migrate --help
+
+# Validate migration result
+proagents validate
+
+# Compare configurations
+proagents migrate diff --from cursor-rules
+```