proagents 1.0.14 → 1.0.16

package/package.json

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

package/proagents/AI_INSTRUCTIONS.md

@@ -57,22 +57,81 @@ 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:**
 
+**IMPORTANT - Multi-AI Environment:**
+When multiple AI tools work on the same project, they don't share context. Before executing ANY `pa:ai-*` command:
+1. ALWAYS read fresh state from files (don't rely on cached/previous knowledge)
+2. Read `./proagents/proagents.config.yaml` for current config
+3. Check which files actually exist in project root
+4. If you detect mismatches, inform user and suggest `pa:ai-sync`
+
 For `pa:ai-list`:
 - Read `./proagents/proagents.config.yaml` and show the `platforms` array
-- Show which AI instruction files exist in project root (CLAUDE.md, GEMINI.md, etc.)
+- Show which AI instruction files exist in project root
 
 For `pa:ai-add`:
-- Tell user to run: `npx proagents ai add`
-- This will show an interactive prompt to select additional AI platforms
-- The command will create the appropriate AI instruction files (.cursorrules, GEMINI.md, etc.)
+1. Show available platforms to user:
+   | Platform | File Created |
+   |----------|--------------|
+   | Claude Code | CLAUDE.md |
+   | Cursor | .cursorrules |
+   | Windsurf | .windsurfrules |
+   | GitHub 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 |
+
+2. Ask user which platforms to add
+3. For each selected platform:
+   - Copy content from `./proagents/{PLATFORM}.md` (e.g., `./proagents/CLAUDE.md`)
+   - If target file exists, wrap new content with markers and append:
+     ```
+     <!-- PROAGENTS:START -->
+     {content from proagents folder}
+     <!-- PROAGENTS:END -->
+     ```
+   - If target file doesn't exist, create it with the content wrapped in markers
+4. Update `./proagents/proagents.config.yaml` to add platform to `platforms` array
 
 For `pa:ai-remove`:
-- Tell user to run: `npx proagents ai remove`
-- This will show which platforms can be removed
-- The command will remove the AI instruction files and update config
+1. Read `./proagents/proagents.config.yaml` to get current platforms
+2. Show list and ask which to remove
+3. For each selected:
+   - 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

@@ -15,9 +15,10 @@ Execute these commands when user types them (prefix: `pa:`):
 | `pa:doc` | Generate documentation |
 | `pa:release` | Generate release notes → `./RELEASE_NOTES.md` |
 | `pa:changelog` | Update `./CHANGELOG.md` |
-| `pa:ai-list` | Show configured AI platforms from config |
-| `pa:ai-add` | Tell user to run `npx proagents ai add` |
-| `pa:ai-remove` | Tell user to run `npx proagents ai remove` |
+| `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