proagents 1.6.10 → 1.6.12

package/.proagents/.active-files

@@ -0,0 +1,4 @@
+# Active File Locks
+# Format: filepath|AI_platform|timestamp
+# AI adds entry when editing, removes on session end
+

package/.proagents/.cursorrules

@@ -2,6 +2,16 @@
 
 This project uses ProAgents workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/.windsurfrules

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/AI_INSTRUCTIONS.md

@@ -31,12 +31,32 @@ This project uses ProAgents - an AI-agnostic development workflow framework.
 
 **Multiple AI tools may work on this project simultaneously. They do NOT share context.**
 
+### AUTOMATIC Context Loading (No Manual pa:sync Needed)
+
+**On FIRST pa: command of session, AI AUTOMATICALLY does:**
+
+```bash
+# 1. Load context (replaces manual pa:sync)
+cat .proagents/worklog/_context.md 2>/dev/null
+cat .proagents/changelog/_recent.md 2>/dev/null | head -30
+tail -10 .proagents/activity.log 2>/dev/null
+
+# 2. Check for conflicts
+cat .proagents/.active-files 2>/dev/null
+
+# 3. Validate previous logging
+git diff --name-only HEAD~3 2>/dev/null | wc -l
+```
+
+**User does NOT need to type pa:sync - it happens automatically.**
+
 ### Before ANY `pa:` command:
 
-1. **Read project context** - `./.proagents/context.md`
+1. **Auto-load context** - Read `worklog/_context.md` and `changelog/_recent.md`
 2. **Check activity log** - `./.proagents/activity.log`
 3. **Check feedback** - `./.proagents/feedback.md` (learn from past corrections!)
 4. **Check watchlist** - `./.proagents/watchlist.yaml` (files requiring confirmation)
+5. **Check file locks** - `./.proagents/.active-files`
 
 ### After ANY `pa:` command:
 
@@ -79,6 +99,216 @@ Check lock before starting. Delete when done.
 
 ---
 
+## CRITICAL: Auto-Log Every Code Change
+
+**AI MUST automatically log EVERY code change. This is NOT optional.**
+
+### After EVERY file edit/create/delete:
+
+AI immediately updates these files (no user prompt needed):
+
+```
+1. .proagents/changelog/_recent.md     ← Prepend change summary
+2. .proagents/worklog/_context.md      ← Update current state
+3. .proagents/changelog/features/X.md  ← If working on feature
+4. .proagents/changelog/modules/X.md   ← Based on file path
+```
+
+### Auto-Log Format for _recent.md:
+
+After editing `src/auth/login.ts`, AI prepends to `_recent.md`:
+
+```markdown
+### [DATE] - Code Change
+**Module:** auth
+**AI:** [Platform] ([model])
+**Files:** src/auth/login.ts (+15, -3)
+**Summary:** Added email validation to login function
+
+---
+```
+
+### Module Detection (Auto):
+
+| File Path Changed | Update This Changelog |
+|-------------------|----------------------|
+| `src/api/*`, `routes/*` | `changelog/modules/api.md` |
+| `src/auth/*` | `changelog/modules/auth.md` |
+| `src/components/*` | `changelog/modules/ui.md` |
+| `src/services/*` | `changelog/modules/services.md` |
+| `src/utils/*`, `lib/*` | `changelog/modules/utils.md` |
+| `tests/*`, `*.test.*` | `changelog/modules/tests.md` |
+| `src/database/*`, `models/*` | `changelog/modules/database.md` |
+
+### Example - AI Edits a File:
+
+```
+User: Fix the login validation bug
+
+AI: [Reads file, makes edit to src/auth/login.ts]
+
+AI: [AUTOMATICALLY does these updates - no user prompt:]
+
+1. Prepends to .proagents/changelog/_recent.md:
+   ### 2024-03-11 - Bug Fix
+   **Module:** auth
+   **AI:** Claude (opus-4)
+   **Files:** src/auth/login.ts (+5, -2)
+   **Summary:** Fixed null check in email validation
+
+2. Updates .proagents/changelog/modules/auth.md (creates if not exists)
+
+3. Updates .proagents/worklog/_context.md with latest change
+
+AI: "Fixed the login validation bug in src/auth/login.ts"
+```
+
+### Log Rollbacks & Corrections Too:
+
+When removing or correcting previous changes, also log:
+
+```markdown
+### YYYY-MM-DD - Rollback/Correction
+**Module:** auth
+**AI:** Claude (opus-4)
+**Files:** src/auth/login.ts (-20 lines removed)
+**Summary:** Reverted email validation - caused login failures
+**Reason:** Previous change broke existing functionality
+
+---
+```
+
+### WRONG vs RIGHT:
+
+| WRONG | RIGHT |
+|-------|-------|
+| Edit file → Tell user "done" | Edit file → Update changelogs → Tell user "done" |
+| Wait for pa:changelog command | Auto-update after every change |
+| Only log at session end | Log immediately after each change |
+| Undo changes silently | Log rollback with reason |
+
+---
+
+## Cross-AI Session Tracking (AUTOMATIC)
+
+**All session tracking is AUTOMATIC. User does NOT need to run these commands manually.**
+
+### Automatic Behavior:
+
+| What | When | User Action Needed |
+|------|------|-------------------|
+| Load context | First pa: command | **None** - Auto |
+| Log changes | After each edit | **None** - Auto |
+| Update _context.md | After each edit | **None** - Auto |
+| Check conflicts | Before editing files | **None** - Auto |
+
+### On First pa: Command (Auto-Sync):
+
+AI automatically reads context (no manual pa:sync needed):
+```bash
+cat .proagents/worklog/_context.md        # Current state
+cat .proagents/changelog/_recent.md       # Recent changes
+tail -10 .proagents/activity.log          # Recent commands
+cat .proagents/.active-files 2>/dev/null  # Check file locks
+```
+
+### During Work (Auto-Log):
+
+After ANY code modification, AI must update:
+
+1. **Session Log** (`worklog/YYYY-MM-DD-[ai]-[num].md`)
+   - Tasks completed
+   - Files changed
+   - Decisions made
+
+2. **Feature Changelog** (`changelog/features/[name].md`)
+   - If working on a feature
+
+3. **Module Changelog** (`changelog/modules/[name].md`)
+   - Based on file paths modified
+
+### On Session End (pa:session-end):
+
+AI updates:
+```bash
+# 1. Update context summary
+# Edit .proagents/worklog/_context.md with current state
+
+# 2. Update recent changes
+# Prepend to .proagents/changelog/_recent.md
+
+# 3. Finalize session log with "Next Steps"
+
+# 4. Log to activity.log
+echo "[$(date '+%Y-%m-%d %H:%M')] [AI:model] [pa:session-end] Session complete" >> .proagents/activity.log
+```
+
+### Module Auto-Detection:
+
+| File Path | Module Changelog |
+|-----------|------------------|
+| `src/api/*` | `modules/api.md` |
+| `src/auth/*` | `modules/auth.md` |
+| `src/components/*` | `modules/ui.md` |
+| `src/services/*` | `modules/services.md` |
+| `tests/*` | `modules/tests.md` |
+
+### Conflict Check (Before Editing):
+
+Before modifying any file, AI checks if another AI recently changed it:
+
+```bash
+grep "src/auth/login.ts" .proagents/changelog/_recent.md
+```
+
+If found, warn user:
+```
+⚠️ File src/auth/login.ts was modified by Gemini 2 hours ago.
+Review changes before editing? [Y/n]
+```
+
+### File-Level Lock:
+
+When editing files, track them:
+
+```bash
+# On edit start:
+echo "src/auth/login.ts|Claude|$(date -Iseconds)" >> .proagents/.active-files
+
+# On session end - clear your locks:
+grep -v "|Claude|" .proagents/.active-files > /tmp/af && mv /tmp/af .proagents/.active-files
+```
+
+### Validation on pa:sync:
+
+AI checks if previous session logged properly:
+
+```bash
+# Compare git changes vs logged changes
+git diff --name-only HEAD~3 2>/dev/null | wc -l  # Files changed
+grep -c "Files:" .proagents/changelog/_recent.md  # Files logged
+```
+
+If mismatch, warn:
+```
+⚠️ Previous session may have unlogged changes. Check git log.
+```
+
+### Issue Linking:
+
+Auto-detect issue numbers from user input and include in changelog:
+
+```markdown
+### 2024-03-11 - Bug Fix
+**Issue:** #123
+**Module:** auth
+**Files:** src/auth/login.ts
+**Summary:** Fixed validation bug
+**Closes:** #123
+```
+
+---
+
 ## Command Quick Reference
 
 ### Aliases
@@ -177,6 +407,21 @@ Check lock before starting. Delete when done.
 | `pa:handoff` | Create handoff notes |
 | `pa:feedback "text"` | Log feedback for AI learning |
 | `pa:decision "title"` | Log architectural decision |
+
+### Cross-AI Continuity (CRITICAL)
+| Command | Action |
+|---------|--------|
+| `pa:sync` | **Run FIRST** - Load project context |
+| `pa:resume` | Quick resume - shows last session + next action |
+| `pa:session-start` | Begin new work session |
+| `pa:session-end` | Finalize session, update logs |
+| `pa:conflict-check` | Check if files modified by other AI |
+| `pa:history` | View command history |
+| `pa:progress` | View feature progress |
+| `pa:changelog` | Update all changelogs |
+| `pa:changelog --from-git` | Auto-populate from git commits |
+| `pa:changelog-feature X` | View feature changelog |
+| `pa:changelog-module X` | View module changelog |
 | `pa:error "desc"` | Log error and solution |
 
 ### Configuration
@@ -219,6 +464,10 @@ When user types a `pa:` command:
 | `pa:fix` | `./workflow-modes/entry-modes.md` |
 | `pa:debug` | `./prompts/10-debug-logs.md` |
 | `pa:logs` | `./prompts/10-debug-logs.md` |
+| `pa:sync` | `./prompts/11-session-tracking.md` |
+| `pa:session-start` | `./prompts/11-session-tracking.md` |
+| `pa:session-end` | `./prompts/11-session-tracking.md` |
+| `pa:changelog` | `./prompts/11-session-tracking.md` + `./prompts/07-documentation.md` |
 
 ---
 

package/.proagents/ANTIGRAVITY.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/BOLT.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/CHATGPT.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/CLAUDE.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/GEMINI.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/GROQ.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/KIRO.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/LOVABLE.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/PROAGENTS.md

@@ -5,7 +5,28 @@ Execute these commands when user types them (prefix: `pa:`):
 ## Quick Aliases
 `pa:f` → feature | `pa:s` → status | `pa:h` → help | `pa:d` → doc | `pa:t` → test | `pa:q` → qa | `pa:a` → analyze | `pa:r` → requirements | `pa:p` → plan | `pa:i` → implement
 
-> **Multi-AI Note:** Multiple AIs may work on this project. Always read `./.proagents/activity.log` before executing commands, and log your actions after completing them.
+> **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)
+
+**User does NOT need to run pa:sync manually.**
+
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit/create/delete, AI MUST immediately update:**
+
+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, `src/services/*`→services
+
+**Do NOT wait for user prompt. Log automatically after every change.**
 
 ## Commands
 
@@ -46,7 +67,7 @@ Execute these commands when user types them (prefix: `pa:`):
 | Command | What to Do |
 |---------|------------|
 | `pa:next` | Show next step in current workflow |
-| `pa:resume` | Resume paused feature from last checkpoint |
+| `pa:resume` | Quick resume - load last session + show next action |
 | `pa:skip` | Skip current phase, move to next |
 | `pa:back` | Go back to previous phase |
 | `pa:progress` | Show visual progress bar |
@@ -59,7 +80,9 @@ Execute these commands when user types them (prefix: `pa:`):
 | `pa:diff` | Show changes since last session |
 | `pa:history` | Show command history with results |
 | `pa:checkpoint` | Create snapshot/restore point |
-| `pa:undo` | Undo last AI action (git revert) |
+| `pa:undo` | Undo last AI action (git revert)
+| `pa:conflict-check` | Check if files modified by other AI |
+| `pa:changelog --from-git` | Auto-populate changelog from git commits | |
 
 ## Sprint & Estimation
 

package/.proagents/REPLIT.md

@@ -2,6 +2,16 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Auto-Log Every Code Change
+
+**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
+
+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 |

package/.proagents/changelog/_recent.md

@@ -0,0 +1,24 @@
+# Recent Changes
+
+> Last 10 changes across all features/modules.
+> Auto-updated by AI after each code change.
+
+---
+
+## Latest Changes
+
+No changes recorded yet.
+
+---
+
+<!--
+Format for entries (AI adds above this line):
+
+### YYYY-MM-DD - [Change Type]
+**Module:** [auto-detected from file path]
+**AI:** [Platform] ([model])
+**Files:** path/to/file.ts (+lines, -lines)
+**Summary:** Brief description of change
+
+---
+-->

package/.proagents/changelog/features/README.md

@@ -0,0 +1,68 @@
+# Feature Changelogs
+
+One file per feature tracking all changes.
+
+---
+
+## Structure
+
+```
+features/
+├── README.md           # This file
+├── user-auth.md        # All changes to user-auth feature
+├── payment-flow.md     # All changes to payment feature
+└── dashboard.md        # All changes to dashboard feature
+```
+
+---
+
+## File Format
+
+Each feature changelog follows this format:
+
+```markdown
+# Feature: [Feature Name]
+
+Created: YYYY-MM-DD
+Status: [active | completed | paused]
+Branch: feature/feature-name
+
+---
+
+## Changelog
+
+### YYYY-MM-DD - [AI Platform]
+**Phase:** implementation
+**Changes:**
+- Added login validation
+- Created LoginForm component
+**Files:**
+- src/auth/login.ts (+50, -10)
+- src/components/LoginForm.tsx (new)
+**Decisions:**
+- Used Formik for form handling
+**Next:** Add password reset flow
+
+---
+
+### YYYY-MM-DD - [AI Platform]
+...
+```
+
+---
+
+## Auto-Creation
+
+When AI runs `pa:feature "user-auth"`:
+1. Creates `features/user-auth.md`
+2. Initializes with template
+3. Updates on every change
+
+---
+
+## Commands
+
+| Command | Action |
+|---------|--------|
+| `pa:changelog` | Update root + feature changelog |
+| `pa:changelog-feature X` | View feature X changelog |

package/.proagents/changelog/modules/README.md

@@ -0,0 +1,62 @@
+# Module Changelogs
+
+Track changes by code module/component.
+
+---
+
+## Structure
+
+```
+modules/
+├── README.md       # This file
+├── api.md          # All API changes
+├── auth.md         # All auth module changes
+├── ui.md           # All UI component changes
+└── database.md     # All database changes
+```
+
+---
+
+## File Format
+
+```markdown
+# Module: [Module Name]
+
+Path: src/[module]/
+Type: [api | service | component | utility]
+
+---
+
+## Changelog
+
+### YYYY-MM-DD - [AI Platform]
+**Context:** [Feature or Fix name]
+**Changes:**
+- Added rate limiting middleware
+- Updated error responses
+**Files:**
+- src/api/middleware/rateLimit.ts (new)
+- src/api/errors.ts (+20, -5)
+
+---
+```
+
+---
+
+## Auto-Detection
+
+AI automatically detects module from file path:
+- `src/api/*` → modules/api.md
+- `src/auth/*` → modules/auth.md
+- `src/components/*` → modules/ui.md
+- `src/services/*` → modules/services.md
+- `src/utils/*` → modules/utils.md
+
+---
+
+## Commands
+
+| Command | Action |
+|---------|--------|
+| `pa:changelog-module X` | View module X changelog |
+| `pa:modules` | List all modules with change counts |