proagents 1.6.12 → 1.6.15

package/.proagents/.cursorrules

@@ -2,9 +2,23 @@
 
 This project uses ProAgents workflow framework.
 
-## CRITICAL: Auto-Log Every Code Change
+## ⚠️ MANDATORY: Every pa: Command Flow
 
-**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+### BEFORE Any pa: Command (Auto-Sync)
+
+**Read these files FIRST before doing anything:**
+
+```bash
+cat .proagents/worklog/_context.md      # Current state
+cat .proagents/changelog/_recent.md     # Recent changes
+tail -10 .proagents/activity.log        # Recent activity
+```
+
+**This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
+
+### AFTER Any pa: Command (Auto-Log)
+
+**After EVERY file edit, IMMEDIATELY update these files:**
 
 1. `.proagents/changelog/_recent.md` - Prepend change summary
 2. `.proagents/changelog/modules/[module].md` - Based on file path

package/.proagents/.learning/global/common-patterns.template.json

@@ -0,0 +1,60 @@
+{
+  "_template_info": {
+    "description": "Template reference for common-patterns.json schema",
+    "note": "DO NOT modify this file - it gets updated with ProAgents upgrades",
+    "usage": "AI reads this to understand expected schema for common-patterns.json"
+  },
+
+  "$schema": "../schemas/patterns-schema.json",
+  "version": "1.0.0",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "patterns": {
+    "component_patterns": [
+      {
+        "id": "pattern-id",
+        "name": "Pattern Name",
+        "frequency": 95,
+        "confidence": 0.98,
+        "template": "code template with {{placeholders}}"
+      }
+    ],
+    "api_patterns": [],
+    "error_handling": [],
+    "testing_patterns": []
+  },
+
+  "anti_patterns": [
+    {
+      "id": "anti-pattern-id",
+      "name": "Anti-pattern Name",
+      "detected_count": 0,
+      "suggestion": "How to fix",
+      "auto_suggest": true
+    }
+  ],
+
+  "learned_from": {
+    "codebase_analysis": 0,
+    "user_corrections": 0,
+    "explicit_teaching": 0
+  },
+
+  "_schema_notes": {
+    "patterns": {
+      "component_patterns": "React/Vue/etc component patterns",
+      "api_patterns": "API handler patterns",
+      "error_handling": "Error handling patterns",
+      "testing_patterns": "Test structure patterns"
+    },
+    "pattern_fields": {
+      "id": "Unique identifier",
+      "name": "Human-readable name",
+      "frequency": "How often used (0-100)",
+      "confidence": "AI confidence (0-1)",
+      "template": "Code template with {{placeholders}}"
+    },
+    "anti_patterns": "Patterns to avoid",
+    "learned_from": "Source of learning data"
+  }
+}

package/.proagents/.learning/global/user-preferences.template.json

@@ -0,0 +1,78 @@
+{
+  "_template_info": {
+    "description": "Template reference for user-preferences.json schema",
+    "note": "DO NOT modify this file - it gets updated with ProAgents upgrades",
+    "usage": "AI reads this to understand expected schema for user-preferences.json"
+  },
+
+  "$schema": "../schemas/user-preferences-schema.json",
+  "version": "1.0.0",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "checkpoint_preferences": {
+    "usually_skips": ["after_requirements", "after_documentation"],
+    "always_reviews": ["after_design", "before_deployment"],
+    "auto_approve_conditions": [
+      {
+        "checkpoint": "after_analysis",
+        "condition": "files_changed < 5",
+        "confidence": 0.85
+      }
+    ]
+  },
+
+  "workflow_preferences": {
+    "preferred_mode": "full",
+    "skip_phases_for_bug_fixes": ["design", "documentation"],
+    "detail_level": "high",
+    "verbosity": "moderate"
+  },
+
+  "code_preferences": {
+    "naming_style": {
+      "components": "PascalCase",
+      "functions": "camelCase",
+      "constants": "UPPER_SNAKE_CASE",
+      "files": "kebab-case"
+    },
+    "formatting": {
+      "indent": 2,
+      "quotes": "single",
+      "semicolons": true,
+      "trailing_commas": "es5"
+    },
+    "patterns": {
+      "state_management": "zustand",
+      "data_fetching": "react-query",
+      "styling": "tailwind"
+    }
+  },
+
+  "review_preferences": {
+    "focus_areas": ["security", "performance", "accessibility"],
+    "thoroughness": "high",
+    "comment_style": "inline"
+  },
+
+  "notification_preferences": {
+    "on_checkpoint": true,
+    "on_completion": true,
+    "on_error": true,
+    "channels": ["terminal"]
+  },
+
+  "learning_consent": {
+    "track_corrections": true,
+    "track_patterns": true,
+    "share_anonymized": false
+  },
+
+  "_schema_notes": {
+    "checkpoint_preferences": "User's checkpoint review preferences",
+    "workflow_preferences": "How user prefers to work",
+    "code_preferences": "Coding style and patterns",
+    "review_preferences": "Code review settings",
+    "notification_preferences": "When to notify",
+    "learning_consent": "Privacy settings for learning"
+  }
+}

package/.proagents/.windsurfrules

@@ -2,9 +2,23 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
-## CRITICAL: Auto-Log Every Code Change
+## ⚠️ MANDATORY: Every pa: Command Flow
 
-**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+### BEFORE Any pa: Command (Auto-Sync)
+
+**Read these files FIRST before doing anything:**
+
+```bash
+cat .proagents/worklog/_context.md      # Current state
+cat .proagents/changelog/_recent.md     # Recent changes
+tail -10 .proagents/activity.log        # Recent activity
+```
+
+**This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
+
+### AFTER Any pa: Command (Auto-Log)
+
+**After EVERY file edit, IMMEDIATELY update these files:**
 
 1. `.proagents/changelog/_recent.md` - Prepend change summary
 2. `.proagents/changelog/modules/[module].md` - Based on file path

package/.proagents/AGENTS.md

@@ -0,0 +1,55 @@
+# ProAgents Commands for Codex
+
+This project uses ProAgents - an AI-agnostic development workflow framework.
+
+## MANDATORY: Every pa: Command Flow
+
+### BEFORE Any pa: Command (Auto-Sync)
+
+**Read these files FIRST before doing anything:**
+
+```bash
+cat .proagents/worklog/_context.md      # Current state
+cat .proagents/changelog/_recent.md     # Recent changes
+tail -10 .proagents/activity.log        # Recent activity
+```
+
+**This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
+
+### AFTER Any pa: Command (Auto-Log)
+
+**After EVERY file edit, IMMEDIATELY update these files:**
+
+1. `.proagents/changelog/_recent.md` - Prepend change summary
+2. `.proagents/changelog/modules/[module].md` - Based on file path
+3. `.proagents/worklog/_context.md` - Update current state
+
+Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
+
+## Essential Commands
+
+| Command | Action |
+|---------|--------|
+| `pa:feature "name"` | Start new feature workflow |
+| `pa:fix "bug"` | Quick bug fix mode |
+| `pa:doc` | Documentation options |
+| `pa:qa` | Quality assurance checks |
+| `pa:test` | Run test workflow |
+| `pa:deploy` | Deployment preparation |
+| `pa:status` | Show current progress |
+
+## Full Command Reference
+
+For complete command list, see: `./.proagents/AI_INSTRUCTIONS.md`
+
+## On `pa:` Command
+
+1. Read the corresponding file from `./.proagents/prompts/` or `./.proagents/workflow-modes/`
+2. Follow the workflow instructions
+3. Use project config from `./.proagents/proagents.config.yaml`
+
+## Key Files
+
+- `./.proagents/AI_INSTRUCTIONS.md` - Complete command reference
+- `./.proagents/WORKFLOW.md` - Full 10-phase workflow
+- `./.proagents/prompts/` - Phase-specific prompts