proagents 1.0.11 → 1.0.12

package/lib/commands/ai.js

@@ -103,11 +103,75 @@ export async function selectPlatforms() {
   return selected.length > 0 ? selected : ['claude']; // Default to Claude if nothing selected
 }
 
+// ProAgents section markers
+const PROAGENTS_START = '<!-- PROAGENTS:START -->';
+const PROAGENTS_END = '<!-- PROAGENTS:END -->';
+
+/**
+ * Wrap ProAgents content with markers
+ */
+function wrapWithMarkers(content) {
+  return `${PROAGENTS_START}\n${content}\n${PROAGENTS_END}`;
+}
+
+/**
+ * Extract ProAgents section from content
+ */
+function extractProagentsSection(content) {
+  const startIdx = content.indexOf(PROAGENTS_START);
+  const endIdx = content.indexOf(PROAGENTS_END);
+
+  if (startIdx !== -1 && endIdx !== -1) {
+    return {
+      before: content.substring(0, startIdx),
+      proagents: content.substring(startIdx, endIdx + PROAGENTS_END.length),
+      after: content.substring(endIdx + PROAGENTS_END.length)
+    };
+  }
+  return null;
+}
+
+/**
+ * Merge ProAgents instructions with existing file content
+ * - If file doesn't exist: create with ProAgents content
+ * - If file exists without ProAgents section: append ProAgents section
+ * - If file exists with ProAgents section: update only ProAgents section
+ */
+function mergeAIInstructions(sourcePath, targetPath) {
+  const sourceContent = readFileSync(sourcePath, 'utf-8');
+  const wrappedSource = wrapWithMarkers(sourceContent);
+
+  if (!existsSync(targetPath)) {
+    // File doesn't exist - create new with wrapped content
+    writeFileSync(targetPath, wrappedSource);
+    return 'created';
+  }
+
+  const existingContent = readFileSync(targetPath, 'utf-8');
+  const sections = extractProagentsSection(existingContent);
+
+  if (sections) {
+    // ProAgents section exists - update it only
+    const newContent = sections.before + wrappedSource + sections.after;
+    writeFileSync(targetPath, newContent);
+    return 'updated';
+  } else {
+    // No ProAgents section - append to existing content
+    const newContent = existingContent.trim() + '\n\n' + wrappedSource + '\n';
+    writeFileSync(targetPath, newContent);
+    return 'merged';
+  }
+}
+
 /**
  * Copy AI instruction files for selected platforms
+ * Merges with existing files instead of replacing them
+ * @param {string[]} selectedIds - Platform IDs to copy
+ * @param {string} sourceDir - Source directory (proagents folder)
+ * @param {string} targetDir - Target directory (project root)
  */
 export function copyPlatformFiles(selectedIds, sourceDir, targetDir) {
-  const results = { created: [], skipped: [], failed: [] };
+  const results = { created: [], updated: [], merged: [], failed: [] };
 
   for (const id of selectedIds) {
     const platform = getPlatformById(id);
@@ -130,11 +194,13 @@ export function copyPlatformFiles(selectedIds, sourceDir, targetDir) {
 
     try {
       if (existsSync(sourcePath)) {
-        if (!existsSync(targetPath)) {
-          cpSync(sourcePath, targetPath);
+        const result = mergeAIInstructions(sourcePath, targetPath);
+        if (result === 'created') {
           results.created.push(platform.name);
-        } else {
-          results.skipped.push(platform.name);
+        } else if (result === 'updated') {
+          results.updated.push(platform.name);
+        } else if (result === 'merged') {
+          results.merged.push(platform.name);
         }
       }
     } catch (error) {
@@ -285,13 +351,16 @@ export async function aiAddCommand() {
 
   // Show results
   if (results.created.length > 0) {
-    console.log(chalk.green(`\n✓ Added: ${results.created.join(', ')}`));
+    console.log(chalk.green(`\n✓ Created: ${results.created.join(', ')}`));
+  }
+  if (results.updated.length > 0) {
+    console.log(chalk.green(`✓ Updated: ${results.updated.join(', ')}`));
   }
-  if (results.skipped.length > 0) {
-    console.log(chalk.yellow(`⚠️  Already exist: ${results.skipped.join(', ')}`));
+  if (results.merged.length > 0) {
+    console.log(chalk.green(`✓ Merged with existing: ${results.merged.join(', ')}`));
   }
 
-  console.log(chalk.gray('\nAI instruction files copied to project root.'));
+  console.log(chalk.gray('\nAI instruction files added to project root.'));
   console.log(chalk.gray('Config updated in proagents/proagents.config.yaml\n'));
 }
 

package/lib/commands/init.js

@@ -258,14 +258,17 @@ For detailed commands, see \`./proagents/PROAGENTS.md\`
     // Interactive AI platform selection
     const selectedPlatforms = await selectPlatforms();
 
-    // Copy AI instruction files for selected platforms
+    // Copy AI instruction files for selected platforms (merges with existing files)
     const aiResults = copyPlatformFiles(selectedPlatforms, sourceDir, targetDir);
 
     if (aiResults.created.length > 0) {
       console.log(chalk.green(`✓ Created AI files: ${aiResults.created.join(', ')}`));
     }
-    if (aiResults.skipped.length > 0) {
-      console.log(chalk.yellow(`⚠️  Skipped (already exist): ${aiResults.skipped.join(', ')}`));
+    if (aiResults.updated.length > 0) {
+      console.log(chalk.green(`✓ Updated AI files: ${aiResults.updated.join(', ')}`));
+    }
+    if (aiResults.merged.length > 0) {
+      console.log(chalk.green(`✓ Merged with existing: ${aiResults.merged.join(', ')}`));
     }
 
     // Save selected platforms to config
@@ -383,7 +386,7 @@ async function smartUpdate(sourceDir, targetDir) {
     }
   }
 
-  // Copy AI instruction files for configured platforms (only if they don't exist)
+  // Copy AI instruction files for configured platforms (merges with existing files)
   const projectRoot = join(targetDir, '..');
   const configPath = join(targetDir, 'proagents.config.yaml');
   const selectedPlatforms = loadPlatformConfig(configPath);
@@ -394,8 +397,11 @@ async function smartUpdate(sourceDir, targetDir) {
     if (aiResults.created.length > 0) {
       console.log(chalk.green(`✓ Created new AI files: ${aiResults.created.join(', ')}`));
     }
-    if (aiResults.skipped.length > 0) {
-      console.log(chalk.gray(`ℹ️  Preserved existing: ${aiResults.skipped.join(', ')}`));
+    if (aiResults.updated.length > 0) {
+      console.log(chalk.green(`✓ Updated AI files: ${aiResults.updated.join(', ')}`));
+    }
+    if (aiResults.merged.length > 0) {
+      console.log(chalk.green(`✓ Merged with existing: ${aiResults.merged.join(', ')}`));
     }
   }
 

package/package.json

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

package/proagents/.cursorrules

@@ -2,70 +2,30 @@
 
 This project uses ProAgents workflow framework.
 
-## Command Recognition
+## Essential Commands
 
-Recognize commands starting with `pa:` prefix:
+| Command | Action |
+|---------|--------|
+| `pa:feature "name"` | Start new feature workflow |
+| `pa:fix "bug"` | Quick bug fix mode |
+| `pa:doc` | Documentation options |
+| `pa:qa` | Quality assurance checks |
+| `pa:test` | Run test workflow |
+| `pa:deploy` | Deployment preparation |
+| `pa:status` | Show current progress |
 
-**Initialization**
-- `pa:init` - Initialize ProAgents in project
-- `pa:help` - Show all commands
-- `pa:status` - Show current progress
+## Full Command Reference
 
-**Feature Development**
-- `pa:feature "name"` - Start feature workflow (see ./proagents/WORKFLOW.md)
-- `pa:feature-start "name"` - Start new feature
-- `pa:feature-status` - Check feature status
-- `pa:feature-list` - List all features
-- `pa:feature-complete` - Mark feature complete
-- `pa:fix "bug"` - Bug fix mode (see ./proagents/workflow-modes/entry-modes.md)
+For complete command list, see: `./proagents/AI_INSTRUCTIONS.md`
 
-**Documentation**
-- `pa:doc` - Documentation options
-- `pa:doc-full` - Generate full documentation (see ./proagents/prompts/07-documentation.md)
-- `pa:doc-moderate` - Balanced documentation
-- `pa:doc-lite` - Quick reference
-- `pa:doc-module [name]` - Document specific module
-- `pa:doc-file [path]` - Document specific file
-- `pa:doc-api` - Generate API documentation
-- `pa:readme` - Generate/update README
-- `pa:changelog` - Update CHANGELOG.md
-- `pa:release` - Generate release notes
+## On `pa:` Command
 
-**Quality & Testing**
-- `pa:qa` - Quality checks (see ./proagents/checklists/code-quality.md)
-- `pa:test` - Test workflow (see ./proagents/prompts/06-testing.md)
-- `pa:review` - Code review workflow
+1. Read the corresponding file from `./proagents/prompts/` or `./proagents/workflow-modes/`
+2. Follow the workflow instructions
+3. Use project config from `./proagents/proagents.config.yaml`
 
-**Deployment**
-- `pa:deploy` - Deployment workflow (see ./proagents/prompts/08-deployment.md)
-- `pa:rollback` - Rollback procedures
+## Key Files
 
-**AI Platform Management**
-- `pa:ai-list` - List installed AI platforms
-- `pa:ai-add` - Add more AI platforms
-- `pa:ai-remove` - Remove AI platforms from config
-
-**Configuration**
-- `pa:config` - Show current configuration
-- `pa:config-list` - List all configurable options
-- `pa:config-show` - Show current config values
-- `pa:config-set K V` - Set a config value
-- `pa:config-get K` - Get a config value
-- `pa:config-setup` - Interactive config wizard
-- `pa:config-customize` - Copy templates to customize
-
-**Utilities**
-- `pa:uninstall` - Remove ProAgents from project
-
-## Workflow
-
-When user types `pa:` command:
-1. Read corresponding prompt from ./proagents/prompts/
-2. Follow the defined workflow
-3. Respect settings in ./proagents/proagents.config.yaml
-
-## Key References
-
-- Workflow: ./proagents/WORKFLOW.md
-- Commands: ./proagents/PROAGENTS.md
-- Prompts: ./proagents/prompts/
+- `./proagents/AI_INSTRUCTIONS.md` - Complete command reference
+- `./proagents/WORKFLOW.md` - Full 10-phase workflow
+- `./proagents/prompts/` - Phase-specific prompts

package/proagents/.github/copilot-instructions.md

@@ -1,69 +1,31 @@
 # ProAgents Commands for GitHub Copilot
 
-This project uses ProAgents workflow framework. Recognize `pa:` prefix commands.
+This project uses ProAgents workflow framework.
 
-## Commands
+## Essential Commands
 
-### Initialization
-- `pa:init` - Initialize ProAgents in project
-- `pa:help` - Show all commands
-- `pa:status` - Show progress
+| Command | Action |
+|---------|--------|
+| `pa:feature "name"` | Start new feature workflow |
+| `pa:fix "bug"` | Quick bug fix mode |
+| `pa:doc` | Documentation options |
+| `pa:qa` | Quality assurance checks |
+| `pa:test` | Run test workflow |
+| `pa:deploy` | Deployment preparation |
+| `pa:status` | Show current progress |
 
-### Feature Development
-- `pa:feature "name"` - Start feature (read ./proagents/WORKFLOW.md)
-- `pa:feature-start "name"` - Start new feature
-- `pa:feature-status` - Check feature status
-- `pa:feature-list` - List all features
-- `pa:feature-complete` - Mark feature complete
-- `pa:fix "bug"` - Bug fix mode (read ./proagents/workflow-modes/entry-modes.md)
+## Full Command Reference
 
-### Documentation
-- `pa:doc` - Documentation options
-- `pa:doc-full` - Full docs (read ./proagents/prompts/07-documentation.md)
-- `pa:doc-moderate` - Balanced docs
-- `pa:doc-lite` - Quick reference
-- `pa:doc-module [name]` - Document module
-- `pa:doc-file [path]` - Document file
-- `pa:doc-api` - API documentation
-- `pa:readme` - Generate README
-- `pa:changelog` - Update CHANGELOG
-- `pa:release` - Release notes
-- `pa:release [ver]` - Version-specific notes
-
-### Quality & Testing
-- `pa:qa` - Quality checks (read ./proagents/checklists/code-quality.md)
-- `pa:test` - Test workflow (read ./proagents/prompts/06-testing.md)
-- `pa:review` - Code review
-
-### Deployment
-- `pa:deploy` - Deployment (read ./proagents/prompts/08-deployment.md)
-- `pa:rollback` - Rollback procedures
-
-### AI Platform Management
-- `pa:ai-list` - List installed AI platforms
-- `pa:ai-add` - Add more AI platforms
-- `pa:ai-remove` - Remove AI platforms from config
-
-### Configuration
-- `pa:config` - Show current configuration
-- `pa:config-list` - List all configurable options
-- `pa:config-show` - Show current config values
-- `pa:config-set K V` - Set a config value
-- `pa:config-get K` - Get a config value
-- `pa:config-setup` - Interactive config wizard
-- `pa:config-customize` - Copy templates to customize
-
-### Utilities
-- `pa:uninstall` - Remove ProAgents from project
+For complete command list, see: `./proagents/AI_INSTRUCTIONS.md`
 
 ## On `pa:` Command
 
-1. Read corresponding file in `./proagents/prompts/` or `./proagents/workflow-modes/`
+1. Read the corresponding file from `./proagents/prompts/` or `./proagents/workflow-modes/`
 2. Follow the workflow instructions
-3. Use config from `./proagents/proagents.config.yaml`
+3. Use project config from `./proagents/proagents.config.yaml`
 
 ## Key Files
 
-- `./proagents/WORKFLOW.md` - Full workflow
-- `./proagents/PROAGENTS.md` - Command reference
-- `./proagents/prompts/` - Phase prompts
+- `./proagents/AI_INSTRUCTIONS.md` - Complete command reference
+- `./proagents/WORKFLOW.md` - Full 10-phase workflow
+- `./proagents/prompts/` - Phase-specific prompts

package/proagents/.windsurfrules

@@ -2,73 +2,30 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
-## Command Recognition
+## Essential Commands
 
-Recognize commands with `pa:` prefix and execute the corresponding workflow.
+| Command | Action |
+|---------|--------|
+| `pa:feature "name"` | Start new feature workflow |
+| `pa:fix "bug"` | Quick bug fix mode |
+| `pa:doc` | Documentation options |
+| `pa:qa` | Quality assurance checks |
+| `pa:test` | Run test workflow |
+| `pa:deploy` | Deployment preparation |
+| `pa:status` | Show current progress |
 
-## Available Commands
+## Full Command Reference
 
-### Initialization
-- `pa:init` - Initialize ProAgents in project
-- `pa:help` - Show all available commands
-- `pa:status` - Show current progress
+For complete command list, see: `./proagents/AI_INSTRUCTIONS.md`
 
-### Feature Development
-- `pa:feature "name"` - Start new feature (read ./proagents/WORKFLOW.md)
-- `pa:feature-start "name"` - Start new feature
-- `pa:feature-status` - Check feature status
-- `pa:feature-list` - List all features
-- `pa:feature-complete` - Mark feature complete
-- `pa:fix "description"` - Quick bug fix mode (read ./proagents/workflow-modes/entry-modes.md)
+## On `pa:` Command
 
-### Documentation Commands
-- `pa:doc` - Show documentation options
-- `pa:doc-full` - Generate full documentation (read ./proagents/prompts/07-documentation.md)
-- `pa:doc-moderate` - Generate balanced documentation
-- `pa:doc-lite` - Generate quick reference
-- `pa:doc-module [name]` - Document specific module
-- `pa:doc-file [path]` - Document specific file
-- `pa:doc-api` - Generate API documentation
-- `pa:readme` - Generate/update README
-- `pa:changelog` - Update CHANGELOG.md
-- `pa:release` - Generate release notes
-- `pa:release [version]` - Version-specific release notes
-
-### Quality & Testing
-- `pa:qa` - Run quality checks (read ./proagents/checklists/code-quality.md)
-- `pa:test` - Run test workflow (read ./proagents/prompts/06-testing.md)
-- `pa:review` - Code review workflow
-
-### Deployment
-- `pa:deploy` - Deployment preparation (read ./proagents/prompts/08-deployment.md)
-- `pa:rollback` - Rollback procedures
-
-### AI Platform Management
-- `pa:ai-list` - List installed AI platforms
-- `pa:ai-add` - Add more AI platforms
-- `pa:ai-remove` - Remove AI platforms from config
-
-### Configuration
-- `pa:config` - Show current configuration
-- `pa:config-list` - List all configurable options
-- `pa:config-show` - Show current config values
-- `pa:config-set K V` - Set a config value
-- `pa:config-get K` - Get a config value
-- `pa:config-setup` - Interactive config wizard
-- `pa:config-customize` - Copy templates to customize
-
-### Utilities
-- `pa:uninstall` - Remove ProAgents from project
-
-## Execution Instructions
-
-When user types a `pa:` command:
-1. Read the corresponding prompt file from `./proagents/prompts/`
-2. Follow the workflow instructions in that file
-3. Use project configuration from `./proagents/proagents.config.yaml`
+1. Read the corresponding file from `./proagents/prompts/` or `./proagents/workflow-modes/`
+2. Follow the workflow instructions
+3. Use project config from `./proagents/proagents.config.yaml`
 
 ## Key Files
 
+- `./proagents/AI_INSTRUCTIONS.md` - Complete command reference
 - `./proagents/WORKFLOW.md` - Full 10-phase workflow
-- `./proagents/PROAGENTS.md` - Quick command reference
-- `./proagents/prompts/` - Phase-specific AI prompts
+- `./proagents/prompts/` - Phase-specific prompts

package/proagents/ANTIGRAVITY.md

@@ -2,113 +2,34 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
-## Command Recognition
+## Essential Commands
 
-When user types commands starting with `pa:`, recognize and execute them:
-
-## Available Commands
-
-### Initialization
-| Command | Description |
-|---------|-------------|
-| `pa:init` | Initialize ProAgents in project |
-| `pa:help` | Show all available commands |
-| `pa:status` | Show current progress |
-
-### Feature Development
-| Command | Description |
-|---------|-------------|
+| Command | Action |
+|---------|--------|
 | `pa:feature "name"` | Start new feature workflow |
-| `pa:feature-start "name"` | Start new feature |
-| `pa:feature-status` | Check feature status |
-| `pa:feature-list` | List all features |
-| `pa:feature-complete` | Mark feature complete |
-| `pa:fix "description"` | Quick bug fix mode |
-
-### Documentation Commands
-| Command | Description |
-|---------|-------------|
-| `pa:doc` | Show documentation options |
-| `pa:doc-full` | Generate full project documentation |
-| `pa:doc-moderate` | Generate balanced documentation |
-| `pa:doc-lite` | Generate quick reference |
-| `pa:doc-module [name]` | Document specific module |
-| `pa:doc-file [path]` | Document specific file |
-| `pa:doc-api` | Generate API documentation |
-| `pa:readme` | Generate/update README |
-| `pa:changelog` | Update CHANGELOG.md |
-| `pa:release` | Generate release notes |
-| `pa:release [version]` | Version-specific release notes |
-
-### Quality & Testing
-| Command | Description |
-|---------|-------------|
-| `pa:qa` | Run quality assurance checks |
+| `pa:fix "bug"` | Quick bug fix mode |
+| `pa:doc` | Documentation options |
+| `pa:qa` | Quality assurance checks |
 | `pa:test` | Run test workflow |
-| `pa:review` | Code review workflow |
-
-### Deployment
-| Command | Description |
-|---------|-------------|
 | `pa:deploy` | Deployment preparation |
-| `pa:rollback` | Rollback procedures |
-
-### AI Platform Management
-| Command | Description |
-|---------|-------------|
-| `pa:ai-list` | List installed AI platforms |
-| `pa:ai-add` | Add more AI platforms |
-| `pa:ai-remove` | Remove AI platforms from config |
-
-### Configuration
-| Command | Description |
-|---------|-------------|
-| `pa:config` | Show current configuration |
-| `pa:config-list` | List all configurable options |
-| `pa:config-show` | Show current config values |
-| `pa:config-set K V` | Set a config value |
-| `pa:config-get K` | Get a config value |
-| `pa:config-setup` | Interactive config wizard |
-| `pa:config-customize` | Copy templates to customize |
-
-### Utilities
-| Command | Description |
-|---------|-------------|
-| `pa:uninstall` | Remove ProAgents from project |
-
-## Execution Instructions
+| `pa:status` | Show current progress |
 
-When user types a `pa:` command:
+## Full Command Reference
 
-1. **Read the corresponding prompt file** from `./proagents/prompts/`
-2. **Follow the workflow** defined in that prompt
-3. **Use project config** from `./proagents/proagents.config.yaml`
+For complete command list, see: `./proagents/AI_INSTRUCTIONS.md`
 
-## Prompt File Mapping
+## On `pa:` Command
 
-| Command | Prompt File |
-|---------|-------------|
-| `pa:feature` | `./proagents/prompts/00-init.md` + `./proagents/WORKFLOW.md` |
-| `pa:fix` | `./proagents/workflow-modes/entry-modes.md` (Bug Fix section) |
-| `pa:doc*` | `./proagents/prompts/07-documentation.md` |
-| `pa:qa` | `./proagents/checklists/code-quality.md` |
-| `pa:test` | `./proagents/prompts/06-testing.md` |
-| `pa:deploy` | `./proagents/prompts/08-deployment.md` |
-| `pa:release` | `./proagents/prompts/07-documentation.md` (Release Notes section) |
+1. Read the corresponding file from `./proagents/prompts/` or `./proagents/workflow-modes/`
+2. Follow the workflow instructions
+3. Use project config from `./proagents/proagents.config.yaml`
 
-## Key Reference Files
+## Key Files
 
-| File | Purpose |
-|------|---------|
-| `./proagents/WORKFLOW.md` | Full 10-phase workflow documentation |
-| `./proagents/PROAGENTS.md` | Quick command reference |
-| `./proagents/prompts/` | Phase-specific AI prompts |
-| `./proagents/proagents.config.yaml` | Project configuration |
+- `./proagents/AI_INSTRUCTIONS.md` - Complete command reference
+- `./proagents/WORKFLOW.md` - Full 10-phase workflow
+- `./proagents/prompts/` - Phase-specific prompts
 
-## Important Notes
+## Note
 
-- Works with both Gemini and Claude models in Antigravity
-- Always check `./proagents/` folder for project-specific configurations
-- Preserve user's `proagents.config.yaml` settings
-- Follow existing code patterns found in the project
-- Use the checklists in `./proagents/checklists/` for quality gates
+Works with both Gemini and Claude models in Antigravity.