proagents 1.0.15 → 1.0.17

package/package.json

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

package/proagents/AI_INSTRUCTIONS.md

@@ -2,6 +2,25 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
+## CRITICAL: Multi-AI Environment
+
+**Multiple AI tools may work on this project simultaneously (Claude, Cursor, Gemini, Copilot, etc.). They do NOT share context.**
+
+Before executing ANY `pa:` command:
+
+1. **ALWAYS read fresh state from files** - Never rely on previous knowledge or cached data
+2. **Key files to check:**
+   - `./proagents/proagents.config.yaml` - Project and platform config
+   - `./proagents/active-features/` - Active feature status
+   - `./CHANGELOG.md` - Recent changes
+   - `./RELEASE_NOTES.md` - Release history
+3. **If you detect conflicts or outdated state:**
+   - Inform the user: "I notice [X] may have changed since my last context. Let me refresh..."
+   - Re-read the relevant files before proceeding
+4. **After making changes:**
+   - Always update the relevant tracking files (status.json, config, etc.)
+   - Other AIs will read these files to stay in sync
+
 ## Command Recognition
 
 When the user types commands starting with `pa:`, recognize and execute them:
@@ -57,6 +76,7 @@ When the user types commands starting with `pa:`, recognize and execute them:
 | `pa:ai-list` | List installed AI platforms |
 | `pa:ai-add` | Add more AI platforms |
 | `pa:ai-remove` | Remove AI platforms from config |
+| `pa:ai-sync` | Sync config with existing files |
 
 **How to execute AI Platform commands:**
 
@@ -100,6 +120,31 @@ For `pa:ai-remove`:
    - Remove the PROAGENTS section (between markers) from the file, OR delete the file if it only contains ProAgents content
    - Update config to remove from `platforms` array
 
+For `pa:ai-sync`:
+1. Scan project root for AI instruction files
+2. Read current config from `./proagents/proagents.config.yaml`
+3. Compare and show differences:
+   - Files that exist but not in config
+   - Config entries that don't have matching files
+4. Ask user: "Add missing files to config?" or "Remove orphan config entries?"
+5. Update config to match actual files
+
+**Platform ID to File Mapping:**
+| Platform ID | File |
+|-------------|------|
+| claude | CLAUDE.md |
+| cursor | .cursorrules |
+| windsurf | .windsurfrules |
+| copilot | .github/copilot-instructions.md |
+| chatgpt | CHATGPT.md |
+| gemini | GEMINI.md |
+| bolt | BOLT.md |
+| lovable | LOVABLE.md |
+| replit | REPLIT.md |
+| kiro | KIRO.md |
+| groq | GROQ.md |
+| antigravity | ANTIGRAVITY.md |
+
 ### Configuration
 | Command | Action |
 |---------|--------|

package/proagents/PROAGENTS.md

@@ -2,6 +2,8 @@
 
 Execute these commands when user types them (prefix: `pa:`):
 
+> **Multi-AI Note:** Multiple AIs may work on this project. Always read fresh state from files before executing commands. See `./proagents/AI_INSTRUCTIONS.md` for details.
+
 ## Commands
 
 | Command | What to Do |
@@ -18,6 +20,7 @@ Execute these commands when user types them (prefix: `pa:`):
 | `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) |
 
 ## Feature Workflow