proagents 1.6.12 → 1.6.13

package/.proagents/ANTIGRAVITY.md

@@ -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/BOLT.md

@@ -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/CHATGPT.md

@@ -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/CLAUDE.md

@@ -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/GEMINI.md

@@ -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/GROQ.md

@@ -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/KIRO.md

@@ -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/LOVABLE.md

@@ -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/PROAGENTS.md

@@ -7,32 +7,52 @@ Execute these commands when user types them (prefix: `pa:`):
 
 > **Multi-AI Note:** Multiple AIs may work on this project. Context loading and logging is AUTOMATIC.
 
-## AUTOMATIC Session Handling
+---
 
-**On FIRST pa: command, AI automatically:**
-1. Reads `.proagents/worklog/_context.md` (context)
-2. Reads `.proagents/changelog/_recent.md` (recent changes)
-3. Checks `.proagents/.active-files` (file locks)
+## ⚠️ MANDATORY: Every pa: Command Flow
 
-**User does NOT need to run pa:sync manually.**
+### BEFORE Any pa: Command (Auto-Sync)
 
-## CRITICAL: Auto-Log Every Code Change
+**AI MUST read these files FIRST before doing anything:**
 
-**After EVERY file edit/create/delete, AI MUST immediately update:**
+```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 That Changes Files
+
+**AI MUST update these files IMMEDIATELY after any code change:**
+
+```
+1. .proagents/changelog/_recent.md     ← Prepend change summary
+2. .proagents/worklog/_context.md      ← Update Quick Summary
+3. .proagents/changelog/modules/X.md   ← Based on file path
+4. .proagents/activity.log             ← Log the command
+```
+
+### Example: pa:fix "login bug"
 
-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
+```
+STEP 1: Read _context.md, _recent.md, activity.log  ← SYNC FIRST
+STEP 2: Find and fix the bug                        ← DO THE WORK
+STEP 3: Prepend fix to _recent.md                   ← LOG CHANGE
+STEP 4: Update _context.md Quick Summary            ← UPDATE CONTEXT
+STEP 5: Append to activity.log                      ← LOG ACTIVITY
+```
 
 **Module detection:** `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui, `src/services/*`→services
 
-**Do NOT wait for user prompt. Log automatically after every change.**
+---
 
 ## Commands
 
 | Command | What to Do |
 |---------|------------|
-| `pa:help` | Show this command table |
+| `pa:help` | Comprehensive help with examples, categories, workflows |
 | `pa:feature "name"` | Create `./.proagents/active-features/feature-[name]/`, analyze codebase, implement feature |
 | `pa:fix "description"` | Find bug, fix it, update `./CHANGELOG.md` |
 | `pa:analyze` | Deep codebase analysis → `./.proagents/cache/` |
@@ -40,17 +60,20 @@ Execute these commands when user types them (prefix: `pa:`):
 | `pa:design` | UI/Architecture design phase |
 | `pa:plan` | Create implementation plan |
 | `pa:implement` | Execute implementation phase |
-| `pa:status` | Read `./.proagents/active-features/*/status.json`, show progress |
-| `pa:qa` | Check code quality, run tests, report issues |
-| `pa:test` | Create/run tests for current work |
+| `pa:status` | Enhanced status: tasks, time, files, tests, git branch, contributors |
+| `pa:qa` | Quality dashboard: security, lint, coverage, bundle, docs, complexity |
+| `pa:test` | Run tests with coverage visualization, module breakdown, slow tests |
+| `pa:review` | Code review checklist: quality, security, testing, documentation |
+| `pa:fix "desc"` | Bug fix with before/after diff, affected tests, auto-verify |
 | `pa:doc` | Generate documentation |
+| `pa:deploy` | Interactive deployment checklist with real-time status, health checks |
 | `pa:release` | Generate release notes → `./RELEASE_NOTES.md` |
 | `pa:changelog` | Update `./CHANGELOG.md` |
 | `pa:ai-list` | Read config, show installed AI platforms |
 | `pa:ai-add` | Show platform options, create AI instruction files |
 | `pa:ai-remove` | Show installed platforms, remove selected files |
 | `pa:ai-sync` | Sync config with existing files (fix mismatches) |
-| `pa:activity` | Show recent AI activity from `./.proagents/activity.log` |
+| `pa:activity` | Show ALL AI activity with icons, time groups, files changed |
 | `pa:lock` | Show lock status, check if another AI is working |
 | `pa:lock-release` | Release your lock after completing work |
 | `pa:handoff` | Create handoff notes → `./.proagents/handoff.md` |
@@ -59,7 +82,7 @@ Execute these commands when user types them (prefix: `pa:`):
 | `pa:decision "title"` | Log architectural decision → `./.proagents/decisions.md` |
 | `pa:error "desc"` | Log error & solution → `./.proagents/errors.md` |
 | `pa:feedback "desc"` | Log feedback for AI learning → `./.proagents/feedback.md` |
-| `pa:standup` | Generate daily standup summary |
+| `pa:standup` | Daily standup: yesterday, today, blockers, team activity, stats |
 | `pa:tech-debt` | Scan for technical debt |
 
 ## Navigation & Flow
@@ -67,10 +90,10 @@ Execute these commands when user types them (prefix: `pa:`):
 | Command | What to Do |
 |---------|------------|
 | `pa:next` | Show next step in current workflow |
-| `pa:resume` | Quick resume - load last session + show next action |
+| `pa:resume` | Compact resume: last session, what was done, next action, hot files |
 | `pa:skip` | Skip current phase, move to next |
 | `pa:back` | Go back to previous phase |
-| `pa:progress` | Show visual progress bar |
+| `pa:progress` | Show enhanced progress: tasks, duration, AI, phase timeline |
 
 ## Context & History
 
@@ -78,9 +101,11 @@ Execute these commands when user types them (prefix: `pa:`):
 |---------|------------|
 | `pa:context` | View project context |
 | `pa:diff` | Show changes since last session |
-| `pa:history` | Show command history with results |
+| `pa:history` | Command history with filters: --today, --ai, --command, --stats |
 | `pa:checkpoint` | Create snapshot/restore point |
-| `pa:undo` | Undo last AI action (git revert)
+| `pa:undo` | Undo last AI action (git revert) |
+| `pa:undo-last` | Undo last AI's entire session (all changes) |
+| `pa:undo-file "path"` | Undo changes to specific file |
 | `pa:conflict-check` | Check if files modified by other AI |
 | `pa:changelog --from-git` | Auto-populate changelog from git commits | |
 
@@ -174,9 +199,10 @@ Execute these commands when user types them (prefix: `pa:`):
 
 | Command | What to Do |
 |---------|------------|
-| `pa:learn "pattern"` | Teach AI a pattern |
-| `pa:forget "pattern"` | Remove learned pattern |
-| `pa:suggestions` | Show AI suggestions |
+| `pa:learn "pattern"` | Teach AI a pattern → saves to `.proagents/.learning/` |
+| `pa:forget "pattern"` | Remove learned pattern from learning data |
+| `pa:learning` | Show learning report: patterns, corrections, preferences |
+| `pa:suggestions` | Show AI suggestions based on learned patterns |
 
 ## API & Documentation
 
@@ -318,7 +344,7 @@ Execute these commands when user types them (prefix: `pa:`):
 | 7. Testing | `pa:test` | Create/run tests |
 | 8. Review | `pa:review` | Quality check |
 | 9. Documentation | `pa:doc` | Update docs |
-| 10. Deployment | `pa:deploy` | Prepare release |
+| 10. Deployment | `pa:deploy` | Interactive deployment checklist |
 
 ## Save Locations
 

package/.proagents/REPLIT.md

@@ -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