proagents 1.0.6 → 1.0.8

package/lib/commands/init.js

@@ -86,6 +86,11 @@ const FRAMEWORK_FILES = [
   'PROAGENTS.md',
   'GETTING-STARTED-STORY.md',
   'slash-commands.json',
+  'CLAUDE.md',
+  '.cursorrules',
+  'AI_INSTRUCTIONS.md',
+  'GEMINI.md',
+  'CHATGPT.md',
 ];
 
 /**
@@ -253,6 +258,35 @@ For detailed commands, see \`./proagents/PROAGENTS.md\`
       console.log(chalk.green('✓ Created README.md with ProAgents commands'));
     }
 
+    // Copy AI instruction files to project root (for AI platform recognition)
+    const aiFiles = [
+      { src: 'CLAUDE.md', target: 'CLAUDE.md', desc: 'Claude AI' },
+      { src: '.cursorrules', target: '.cursorrules', desc: 'Cursor AI' },
+      { src: 'GEMINI.md', target: 'GEMINI.md', desc: 'Gemini AI' },
+      { src: 'CHATGPT.md', target: 'CHATGPT.md', desc: 'ChatGPT/Codex' },
+    ];
+
+    for (const file of aiFiles) {
+      const sourcePath = join(sourceDir, file.src);
+      const targetPath = join(targetDir, file.target);
+      if (existsSync(sourcePath) && !existsSync(targetPath)) {
+        cpSync(sourcePath, targetPath);
+        console.log(chalk.green(`✓ Created ${file.target} (for ${file.desc} recognition)`));
+      }
+    }
+
+    // Copy .github/copilot-instructions.md for GitHub Copilot
+    const copilotSource = join(sourceDir, '.github', 'copilot-instructions.md');
+    const githubDir = join(targetDir, '.github');
+    const copilotTarget = join(githubDir, 'copilot-instructions.md');
+    if (existsSync(copilotSource) && !existsSync(copilotTarget)) {
+      if (!existsSync(githubDir)) {
+        mkdirSync(githubDir, { recursive: true });
+      }
+      cpSync(copilotSource, copilotTarget);
+      console.log(chalk.green('✓ Created .github/copilot-instructions.md (for GitHub Copilot)'));
+    }
+
     // Success message
     console.log(chalk.green('\n✓ ProAgents initialized successfully!\n'));
 
@@ -363,6 +397,45 @@ async function smartUpdate(sourceDir, targetDir) {
       }
     }
   }
+
+  // Copy AI instruction files to project root (for AI platform recognition)
+  const projectRoot = join(targetDir, '..');
+  const aiFiles = [
+    'CLAUDE.md',
+    '.cursorrules',
+    'AI_INSTRUCTIONS.md',
+    'GEMINI.md',
+    'CHATGPT.md',
+  ];
+  let aiFilesUpdated = 0;
+
+  for (const file of aiFiles) {
+    const sourcePath = join(sourceDir, file);
+    const targetPath = join(projectRoot, file);
+
+    if (existsSync(sourcePath)) {
+      cpSync(sourcePath, targetPath, { force: true });
+      aiFilesUpdated++;
+    }
+  }
+
+  // Handle .github/copilot-instructions.md separately (needs directory creation)
+  const copilotSource = join(sourceDir, '.github', 'copilot-instructions.md');
+  const githubDir = join(projectRoot, '.github');
+  const copilotTarget = join(githubDir, 'copilot-instructions.md');
+
+  if (existsSync(copilotSource)) {
+    if (!existsSync(githubDir)) {
+      mkdirSync(githubDir, { recursive: true });
+    }
+    cpSync(copilotSource, copilotTarget, { force: true });
+    aiFilesUpdated++;
+  }
+
+  if (aiFilesUpdated > 0) {
+    console.log(chalk.green(`✓ Updated ${aiFilesUpdated} AI instruction files`));
+    console.log(chalk.gray('   (CLAUDE.md, .cursorrules, GEMINI.md, CHATGPT.md, .github/copilot-instructions.md)'));
+  }
 }
 
 /**

package/package.json

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

package/proagents/.cursorrules

@@ -0,0 +1,33 @@
+# ProAgents Rules for Cursor
+
+This project uses ProAgents workflow framework.
+
+## Command Recognition
+
+Recognize commands starting with `pa:` prefix:
+
+- `pa:help` - Show all commands
+- `pa:feature "name"` - Start feature workflow (see ./proagents/WORKFLOW.md)
+- `pa:fix "bug"` - Bug fix mode (see ./proagents/workflow-modes/entry-modes.md)
+- `pa:status` - Show progress
+- `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:qa` - Quality checks (see ./proagents/checklists/code-quality.md)
+- `pa:test` - Test workflow (see ./proagents/prompts/06-testing.md)
+- `pa:deploy` - Deployment workflow (see ./proagents/prompts/08-deployment.md)
+- `pa:release` - Generate release notes
+
+## 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/

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

@@ -0,0 +1,45 @@
+# ProAgents Commands for GitHub Copilot
+
+This project uses ProAgents workflow framework. Recognize `pa:` prefix commands.
+
+## Commands
+
+### Core
+- `pa:help` - Show all commands
+- `pa:feature "name"` - Start feature (read ./proagents/WORKFLOW.md)
+- `pa:fix "bug"` - Bug fix mode (read ./proagents/workflow-modes/entry-modes.md)
+- `pa:status` - Show progress
+
+### 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
+- `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
+
+## On `pa:` Command
+
+1. Read corresponding file in `./proagents/prompts/` or `./proagents/workflow-modes/`
+2. Follow the workflow instructions
+3. Use config from `./proagents/proagents.config.yaml`
+
+## Key Files
+
+- `./proagents/WORKFLOW.md` - Full workflow
+- `./proagents/PROAGENTS.md` - Command reference
+- `./proagents/prompts/` - Phase prompts

package/proagents/AI_INSTRUCTIONS.md

@@ -0,0 +1,71 @@
+# AI Instructions for ProAgents
+
+This project uses ProAgents - an AI-agnostic development workflow framework.
+
+## Command Recognition
+
+When the user types commands starting with `pa:`, recognize and execute them:
+
+### Core Commands
+| Command | Action |
+|---------|--------|
+| `pa:help` | Show all available commands |
+| `pa:feature "name"` | Start new feature workflow |
+| `pa:fix "description"` | Quick bug fix mode |
+| `pa:status` | Show current progress |
+
+### Documentation Commands
+| Command | Action |
+|---------|--------|
+| `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 Commands
+| Command | Action |
+|---------|--------|
+| `pa:qa` | Run quality assurance checks |
+| `pa:test` | Run test workflow |
+| `pa:review` | Code review workflow |
+
+### Deployment Commands
+| Command | Action |
+|---------|--------|
+| `pa:deploy` | Deployment preparation |
+| `pa:rollback` | Rollback procedures |
+
+## How to Execute Commands
+
+When user types a `pa:` command:
+
+1. **Read the corresponding prompt file** from `./proagents/prompts/`
+2. **Follow the workflow** defined in that prompt
+3. **Use project context** from `./proagents/` folder
+
+### Prompt File Mapping
+- `pa:feature` → `./proagents/prompts/00-init.md` + workflow
+- `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)
+
+## Workflow Reference
+
+Full workflow documentation: `./proagents/WORKFLOW.md`
+Quick command reference: `./proagents/PROAGENTS.md`
+
+## Important
+
+- Always check `./proagents/` folder for project-specific configurations
+- Preserve user's `proagents.config.yaml` settings
+- Follow existing code patterns found in the project

package/proagents/CHATGPT.md

@@ -0,0 +1,79 @@
+# ProAgents Commands for ChatGPT / Codex
+
+This project uses ProAgents - an AI-agnostic development workflow framework.
+
+## Command Recognition
+
+When user types commands starting with `pa:`, recognize and execute them:
+
+## Available Commands
+
+### Core Commands
+| Command | Action |
+|---------|--------|
+| `pa:help` | Show all available commands |
+| `pa:feature "name"` | Start new feature workflow |
+| `pa:fix "description"` | Quick bug fix mode |
+| `pa:status` | Show current progress |
+
+### Documentation Commands
+| Command | Action |
+|---------|--------|
+| `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 Commands
+| Command | Action |
+|---------|--------|
+| `pa:qa` | Run quality assurance checks |
+| `pa:test` | Run test workflow |
+| `pa:review` | Code review workflow |
+
+### Deployment Commands
+| Command | Action |
+|---------|--------|
+| `pa:deploy` | Deployment preparation |
+| `pa:rollback` | Rollback procedures |
+
+## Execution Instructions
+
+When user types a `pa:` command:
+
+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`
+
+## Prompt File Mapping
+
+- `pa:feature` → Read `./proagents/prompts/00-init.md` and `./proagents/WORKFLOW.md`
+- `pa:fix` → Read `./proagents/workflow-modes/entry-modes.md` (Bug Fix Fast Track section)
+- `pa:doc*` → Read `./proagents/prompts/07-documentation.md`
+- `pa:qa` → Read `./proagents/checklists/code-quality.md`
+- `pa:test` → Read `./proagents/prompts/06-testing.md`
+- `pa:deploy` → Read `./proagents/prompts/08-deployment.md`
+- `pa:release` → Read `./proagents/prompts/07-documentation.md` (Release Notes section)
+
+## Key Reference 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 |
+
+## Important Notes
+
+- 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

package/proagents/CLAUDE.md

@@ -0,0 +1,33 @@
+# ProAgents Commands for Claude
+
+This project uses ProAgents. Recognize `pa:` commands:
+
+## Commands
+
+```
+pa:help              → Show all commands
+pa:feature "name"    → Start feature (read ./proagents/WORKFLOW.md)
+pa:fix "bug"         → Bug fix mode (read ./proagents/workflow-modes/entry-modes.md)
+pa:status            → Show progress
+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:qa                → Quality checks (read ./proagents/checklists/code-quality.md)
+pa:test              → Test workflow (read ./proagents/prompts/06-testing.md)
+pa:deploy            → Deployment (read ./proagents/prompts/08-deployment.md)
+pa:release           → Release notes
+pa:release [ver]     → Version-specific notes
+```
+
+## On `pa:` command
+
+1. Read the corresponding file in `./proagents/prompts/` or `./proagents/workflow-modes/`
+2. Follow the workflow instructions
+3. Use project config from `./proagents/proagents.config.yaml`
+
+## Key Files
+
+- `./proagents/WORKFLOW.md` - Full 10-phase workflow
+- `./proagents/PROAGENTS.md` - Quick command reference
+- `./proagents/prompts/` - Phase-specific prompts

package/proagents/GEMINI.md

@@ -0,0 +1,70 @@
+# ProAgents Commands for Gemini
+
+This project uses ProAgents - an AI-agnostic development workflow framework.
+
+## Command Recognition
+
+When user types commands starting with `pa:`, recognize and execute them:
+
+## Core Commands
+```
+pa:help              → Show all available commands
+pa:feature "name"    → Start new feature workflow
+pa:fix "description" → Quick bug fix mode
+pa:status            → Show current progress
+```
+
+## Documentation Commands
+```
+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 Commands
+```
+pa:qa                → Run quality assurance checks
+pa:test              → Run test workflow
+pa:review            → Code review workflow
+```
+
+## Deployment Commands
+```
+pa:deploy            → Deployment preparation
+pa:rollback          → Rollback procedures
+```
+
+## How to Execute
+
+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`
+
+## Prompt File Mapping
+
+| 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) |
+
+## Key Files
+
+- `./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