proagents 1.6.11 → 1.6.12

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:
 
@@ -169,21 +189,30 @@ When removing or correcting previous changes, also log:
 
 ---
 
-## Cross-AI Session Tracking (MANDATORY)
+## Cross-AI Session Tracking (AUTOMATIC)
+
+**All session tracking is AUTOMATIC. User does NOT need to run these commands manually.**
+
+### Automatic Behavior:
 
-**Every AI must track work for other AIs to continue.**
+| 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 Session Start (pa:sync):
+### On First pa: Command (Auto-Sync):
 
-AI reads these files to get context:
+AI automatically reads context (no manual pa:sync needed):
 ```bash
 cat .proagents/worklog/_context.md        # Current state
 cat .proagents/changelog/_recent.md       # Recent changes
-ls -t .proagents/worklog/*.md | head -3   # Last 2 session logs
-cat .proagents/active-features/_index.json # Active features
+tail -10 .proagents/activity.log          # Recent commands
+cat .proagents/.active-files 2>/dev/null  # Check file locks
 ```
 
-### During Work:
+### During Work (Auto-Log):
 
 After ANY code modification, AI must update:
 

package/.proagents/PROAGENTS.md

@@ -5,7 +5,16 @@ 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
 

package/.proagents/prompts/11-session-tracking.md

@@ -72,16 +72,22 @@ AI: "Fixed the login bug in src/auth/login.ts"
 
 | Command | Action |
 |---------|--------|
-| `pa:sync` | Load context (run FIRST) |
-| `pa:session-start` | Begin work session |
-| `pa:session-end` | End session, finalize logs |
+| `pa:sync` | Load context (AUTO on first command) |
+| `pa:session-start` | Begin work session (AUTO) |
+| `pa:session-end` | End session (AUTO - logs on each change) |
 | `pa:handoff` | Create detailed handoff |
 
 ---
 
-## pa:sync - Load Project Context
+## AUTOMATIC Context Loading
 
-**Run this FIRST when starting work on any AI platform.**
+**User does NOT need to run pa:sync manually.**
+
+On FIRST pa: command of any session, AI automatically loads context.
+
+## pa:sync - Load Project Context (AUTOMATIC)
+
+**This runs AUTOMATICALLY on first pa: command. User can also run manually.**
 
 ### AI Workflow:
 

package/README.md

@@ -80,21 +80,20 @@ Multiple AIs can work on the same project with full context sharing:
 
 | Feature | Description |
 |---------|-------------|
-| **Session Tracking** | Each AI logs detailed work sessions |
-| **Context Sync** | `pa:sync` loads full project context instantly |
+| **Auto Context Loading** | AI automatically loads context on first command |
+| **Auto Change Logging** | Every code change logged automatically |
 | **Feature Changelogs** | Per-feature change history |
 | **Module Changelogs** | Per-module change history |
+| **Conflict Detection** | Warns if files modified by other AI |
 | **Activity Log** | Track what each AI does with model name |
-| **Handoff Notes** | Pass context between AI sessions |
 
 ```bash
-# Start work on any AI platform
-pa:sync              # Load context from other AIs
-pa:session-start     # Begin tracking your work
+# Just start working - context loads automatically!
+pa:feature "add login"    # AI auto-loads context, then works
+pa:fix "bug in auth"      # AI auto-loads context, then fixes
 
-# Do work...
-
-pa:session-end       # Save context for next AI
+# No manual pa:sync needed - it's automatic
+# No manual pa:session-end needed - changes logged automatically
 ```
 
 ### Project Templates

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proagents",
-  "version": "1.6.11",
+  "version": "1.6.12",
   "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
   "type": "module",
   "main": "lib/index.js",