proagents 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 prakashpro3
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+# ProAgents
+
+**AI-Agnostic Development Workflow Framework**
+
+A portable, universal development workflow framework that automates the full software development lifecycle. Works with **any AI platform** (Claude, ChatGPT, Gemini, Copilot, etc.) and **any IDE**.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://img.shields.io/npm/v/proagents.svg)](https://www.npmjs.com/package/proagents)
+
+---
+
+## Installation
+
+```bash
+# Install globally
+npm install -g proagents
+
+# Or use directly with npx
+npx proagents init
+```
+
+---
+
+## Why ProAgents?
+
+- **No vendor lock-in** - Switch AI platforms without changing your workflow
+- **Full lifecycle automation** - From requirements to deployment
+- **Self-learning** - Adapts to your coding patterns and preferences
+- **Flexible entry points** - Full workflow, bug fix mode, or quick changes
+
+---
+
+## Quick Start
+
+### 1. Initialize ProAgents in your project
+
+```bash
+cd your-project
+npx proagents init
+```
+
+### 2. Start a feature
+
+**Using CLI:**
+```bash
+proagents feature start "Add user authentication"
+```
+
+**Using AI assistant (Claude, ChatGPT, etc.):**
+```
+/feature-start "Add user authentication"
+```
+
+### 3. Follow the guided workflow
+
+The AI guides you through 10 phases:
+
+```
+Init → Analysis → Requirements → Design → Planning →
+Implementation → Testing → Review → Documentation → Deployment
+```
+
+---
+
+## CLI Commands
+
+```bash
+proagents init                      # Initialize in current project
+proagents feature start "name"      # Start a new feature
+proagents feature status            # Check feature status
+proagents fix "bug description"     # Quick bug fix mode
+proagents status                    # Show ProAgents status
+proagents docs                      # Open documentation
+proagents commands                  # Show all commands
+```
+
+---
+
+## Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **AI Agnostic** | Works with Claude, ChatGPT, Gemini, Copilot, and more |
+| **IDE Agnostic** | VS Code, JetBrains, Cursor, Neovim, any editor |
+| **10-Phase Workflow** | Complete SDLC from analysis to deployment |
+| **Self-Learning** | Learns your patterns, conventions, and preferences |
+| **Flexible Modes** | Full workflow, bug fix fast-track, or quick changes |
+| **Parallel Development** | Work on multiple features with conflict detection |
+| **Git Integration** | Branching, commits, PRs, and rollback strategies |
+| **PM Integration** | Jira, Linear, GitHub Issues, Notion, and more |
+
+---
+
+## Slash Commands
+
+Type `/` in your AI assistant to see available commands:
+
+| Command | Description |
+|---------|-------------|
+| `/init` | Initialize ProAgents in your project |
+| `/feature-start` | Start a new feature |
+| `/fix` | Quick bug fix mode |
+| `/doc` | Generate documentation |
+| `/qa` | Quality assurance checks |
+| `/test` | Run test workflows |
+| `/deploy` | Deployment preparation |
+| `/status` | Check current status |
+| `/help` | Show all commands |
+
+---
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Getting Started Story](./proagents/GETTING-STARTED-STORY.md) | Narrative walkthrough of a typical day |
+| [Complete Workflow Guide](./proagents/WORKFLOW.md) | Detailed 10-phase workflow documentation |
+| [Configuration Reference](./proagents/config/README.md) | Configuration options |
+| [Examples](./proagents/examples/) | Project-specific walkthroughs |
+| [Prompts](./proagents/prompts/) | AI prompts for each phase |
+
+---
+
+## Project Structure
+
+```
+proagents/
+├── README.md                 # Quick start guide
+├── WORKFLOW.md               # Complete workflow documentation
+├── proagents.config.yaml     # Configuration template
+├── prompts/                  # AI prompts for each phase
+├── templates/                # Output document templates
+├── checklists/               # Quality checklists
+├── standards/                # Customizable coding standards
+├── examples/                 # Project type walkthroughs
+├── config/                   # Integration configurations
+└── ...                       # Additional modules
+```
+
+---
+
+## Supported Integrations
+
+**Project Management:** Jira, Linear, GitHub Issues, GitLab Issues, Asana, Trello, Notion
+
+**Version Control:** GitHub, GitLab
+
+**Communication:** Slack
+
+**CI/CD:** GitHub Actions, GitLab CI, Jenkins, Azure DevOps
+
+---
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+---
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## Acknowledgments
+
+Built for developers who want to automate their workflow without vendor lock-in.
+
+**Co-authored with Claude (Anthropic)**

package/bin/proagents.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { initCommand } from '../lib/commands/init.js';
+import { featureCommand } from '../lib/commands/feature.js';
+import { fixCommand } from '../lib/commands/fix.js';
+import { statusCommand } from '../lib/commands/status.js';
+import { helpCommand } from '../lib/commands/help.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Read package.json for version
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')
+);
+
+program
+  .name('proagents')
+  .description('AI-agnostic development workflow framework')
+  .version(packageJson.version);
+
+// Init command
+program
+  .command('init')
+  .description('Initialize ProAgents in the current project')
+  .option('-f, --force', 'Overwrite existing proagents folder')
+  .option('--skip-config', 'Skip creating config file')
+  .action(initCommand);
+
+// Feature commands
+const feature = program
+  .command('feature')
+  .description('Feature development commands');
+
+feature
+  .command('start <name>')
+  .description('Start a new feature')
+  .action((name) => featureCommand('start', name));
+
+feature
+  .command('status')
+  .description('Check current feature status')
+  .action(() => featureCommand('status'));
+
+feature
+  .command('list')
+  .description('List all features')
+  .action(() => featureCommand('list'));
+
+feature
+  .command('complete')
+  .description('Mark current feature as complete')
+  .action(() => featureCommand('complete'));
+
+// Fix command
+program
+  .command('fix <description>')
+  .description('Quick bug fix mode')
+  .option('--upgrade', 'Upgrade to full workflow')
+  .action(fixCommand);
+
+// Status command
+program
+  .command('status')
+  .description('Show ProAgents status in current project')
+  .action(statusCommand);
+
+// Docs command
+program
+  .command('docs')
+  .description('Open ProAgents documentation')
+  .action(() => {
+    console.log('\nProAgents Documentation');
+    console.log('=======================\n');
+    console.log('Local: ./proagents/README.md');
+    console.log('Workflow: ./proagents/WORKFLOW.md');
+    console.log('GitHub: https://github.com/prakashpro3/proAgents\n');
+  });
+
+// Help command (custom)
+program
+  .command('commands')
+  .description('Show all available commands with examples')
+  .action(helpCommand);
+
+program.parse();

package/lib/commands/feature.js

@@ -0,0 +1,125 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+
+/**
+ * Feature development commands
+ */
+export async function featureCommand(action, name = '') {
+  const targetDir = process.cwd();
+  const proagentsDir = join(targetDir, 'proagents');
+  const activeFeaturesDir = join(proagentsDir, 'active-features');
+
+  // Check if initialized
+  if (!existsSync(proagentsDir)) {
+    console.log(chalk.red('\n✗ ProAgents is not initialized in this project.'));
+    console.log(chalk.gray('  Run: proagents init\n'));
+    return;
+  }
+
+  switch (action) {
+    case 'start':
+      startFeature(name, activeFeaturesDir);
+      break;
+    case 'status':
+      showFeatureStatus(activeFeaturesDir);
+      break;
+    case 'list':
+      listFeatures(activeFeaturesDir);
+      break;
+    case 'complete':
+      completeFeature(activeFeaturesDir);
+      break;
+    default:
+      console.log(chalk.yellow(`Unknown action: ${action}`));
+  }
+}
+
+function startFeature(name, activeFeaturesDir) {
+  if (!name) {
+    console.log(chalk.red('\n✗ Feature name is required.'));
+    console.log(chalk.gray('  Usage: proagents feature start "feature name"\n'));
+    return;
+  }
+
+  console.log('\n' + chalk.bold.blue('Starting Feature: ' + name));
+  console.log(chalk.blue('─'.repeat(40)) + '\n');
+
+  // Create feature directory
+  const featureSlug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+  const featureDir = join(activeFeaturesDir, `feature-${featureSlug}`);
+
+  if (!existsSync(activeFeaturesDir)) {
+    mkdirSync(activeFeaturesDir, { recursive: true });
+  }
+
+  if (existsSync(featureDir)) {
+    console.log(chalk.yellow('⚠️  A feature with this name already exists.'));
+    console.log(chalk.gray('   Use a different name or complete the existing feature.\n'));
+    return;
+  }
+
+  mkdirSync(featureDir, { recursive: true });
+
+  // Create status file
+  const status = {
+    id: `feature-${featureSlug}`,
+    name: name,
+    current_phase: 'init',
+    phase_progress: 0,
+    started: new Date().toISOString(),
+    last_updated: new Date().toISOString()
+  };
+
+  writeFileSync(join(featureDir, 'status.json'), JSON.stringify(status, null, 2));
+
+  console.log(chalk.green('✓ Feature created: ' + featureSlug));
+  console.log('\n' + chalk.bold('Now use your AI assistant with this prompt:'));
+  console.log(chalk.cyan('─'.repeat(50)));
+  console.log(chalk.white(`
+/feature-start "${name}"
+
+Or paste this to your AI:
+
+I want to start a new feature: "${name}"
+Please follow the ProAgents workflow in ./proagents/
+Start with Phase 1: Analysis
+`));
+  console.log(chalk.cyan('─'.repeat(50)) + '\n');
+}
+
+function showFeatureStatus(activeFeaturesDir) {
+  console.log('\n' + chalk.bold.blue('Feature Status'));
+  console.log(chalk.blue('─'.repeat(40)) + '\n');
+
+  if (!existsSync(activeFeaturesDir)) {
+    console.log(chalk.gray('No active features.\n'));
+    return;
+  }
+
+  const features = readdirSync(activeFeaturesDir).filter(f => f.startsWith('feature-'));
+
+  if (features.length === 0) {
+    console.log(chalk.gray('No active features.\n'));
+    return;
+  }
+
+  features.forEach(feature => {
+    const statusFile = join(activeFeaturesDir, feature, 'status.json');
+    if (existsSync(statusFile)) {
+      const status = JSON.parse(readFileSync(statusFile, 'utf-8'));
+      console.log(chalk.white(`• ${status.name}`));
+      console.log(chalk.gray(`  Phase: ${status.current_phase} | Progress: ${status.phase_progress}%`));
+      console.log(chalk.gray(`  Started: ${new Date(status.started).toLocaleDateString()}\n`));
+    }
+  });
+}
+
+function listFeatures(activeFeaturesDir) {
+  showFeatureStatus(activeFeaturesDir);
+}
+
+function completeFeature(activeFeaturesDir) {
+  console.log(chalk.yellow('\n⚠️  Feature completion should be done through your AI assistant.'));
+  console.log(chalk.gray('   The AI will handle documentation, testing, and deployment steps.\n'));
+}

package/lib/commands/fix.js

@@ -0,0 +1,60 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+
+/**
+ * Quick bug fix command
+ */
+export async function fixCommand(description, options = {}) {
+  const targetDir = process.cwd();
+  const proagentsDir = join(targetDir, 'proagents');
+
+  // Check if initialized
+  if (!existsSync(proagentsDir)) {
+    console.log(chalk.red('\n✗ ProAgents is not initialized in this project.'));
+    console.log(chalk.gray('  Run: proagents init\n'));
+    return;
+  }
+
+  console.log('\n' + chalk.bold.blue('Bug Fix Mode'));
+  console.log(chalk.blue('─'.repeat(40)) + '\n');
+
+  if (options.upgrade) {
+    console.log(chalk.yellow('Upgrading to full workflow mode...\n'));
+    console.log(chalk.white('Use this prompt with your AI:'));
+    console.log(chalk.cyan('─'.repeat(50)));
+    console.log(chalk.white(`
+/feature-start "Fix: ${description}"
+
+This bug fix has been upgraded to full workflow mode.
+Please follow all phases in ./proagents/WORKFLOW.md
+`));
+    console.log(chalk.cyan('─'.repeat(50)) + '\n');
+    return;
+  }
+
+  console.log(chalk.green('✓ Bug fix mode activated'));
+  console.log(chalk.gray(`  Issue: ${description}\n`));
+
+  console.log(chalk.bold('Use this prompt with your AI assistant:'));
+  console.log(chalk.cyan('─'.repeat(50)));
+  console.log(chalk.white(`
+/fix "${description}"
+
+Or paste this to your AI:
+
+I need to fix a bug: "${description}"
+
+Please follow the Bug Fix Fast Track in ./proagents/workflow-modes/entry-modes.md:
+1. Context Scan - Identify affected files
+2. Root Cause Analysis - Find the bug source
+3. Fix Implementation - Apply minimal fix
+4. Verification - Test the fix
+5. Commit & Document - Commit with description
+
+Keep the fix focused and minimal. Don't scope creep.
+`));
+  console.log(chalk.cyan('─'.repeat(50)) + '\n');
+
+  console.log(chalk.gray('Tip: Use --upgrade flag to switch to full workflow if the fix is complex.\n'));
+}

package/lib/commands/help.js

@@ -0,0 +1,76 @@
+import chalk from 'chalk';
+
+/**
+ * Show detailed help with all commands
+ */
+export async function helpCommand() {
+  console.log('\n' + chalk.bold.blue('ProAgents Commands'));
+  console.log(chalk.blue('═'.repeat(50)) + '\n');
+
+  // Initialization
+  console.log(chalk.bold.white('Initialization'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(chalk.cyan('proagents init') + '              Initialize in current project');
+  console.log(chalk.cyan('proagents init --force') + '      Overwrite existing installation');
+  console.log('');
+
+  // Feature Development
+  console.log(chalk.bold.white('Feature Development'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(chalk.cyan('proagents feature start "name"') + '  Start a new feature');
+  console.log(chalk.cyan('proagents feature status') + '        Show current feature status');
+  console.log(chalk.cyan('proagents feature list') + '          List all features');
+  console.log(chalk.cyan('proagents feature complete') + '      Mark feature complete');
+  console.log('');
+
+  // Bug Fixing
+  console.log(chalk.bold.white('Bug Fixing'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(chalk.cyan('proagents fix "description"') + '     Quick bug fix mode');
+  console.log(chalk.cyan('proagents fix "desc" --upgrade') + '  Upgrade to full workflow');
+  console.log('');
+
+  // Status & Info
+  console.log(chalk.bold.white('Status & Info'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(chalk.cyan('proagents status') + '            Show ProAgents status');
+  console.log(chalk.cyan('proagents docs') + '              Open documentation');
+  console.log(chalk.cyan('proagents commands') + '          Show this help');
+  console.log(chalk.cyan('proagents --version') + '         Show version');
+  console.log('');
+
+  // Slash Commands
+  console.log(chalk.bold.white('Slash Commands (for AI Assistants)'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(chalk.cyan('/init') + '                  Initialize ProAgents');
+  console.log(chalk.cyan('/feature-start "name"') + '  Start a feature');
+  console.log(chalk.cyan('/fix "description"') + '     Quick bug fix');
+  console.log(chalk.cyan('/status') + '                Check status');
+  console.log(chalk.cyan('/doc') + '                   Generate documentation');
+  console.log(chalk.cyan('/qa') + '                    Quality assurance');
+  console.log(chalk.cyan('/test') + '                  Run tests');
+  console.log(chalk.cyan('/deploy') + '                Deployment workflow');
+  console.log('');
+
+  // Examples
+  console.log(chalk.bold.white('Examples'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(chalk.gray('# Initialize ProAgents in your project'));
+  console.log(chalk.white('cd my-project'));
+  console.log(chalk.white('npx proagents init'));
+  console.log('');
+  console.log(chalk.gray('# Start a new feature'));
+  console.log(chalk.white('proagents feature start "Add user authentication"'));
+  console.log('');
+  console.log(chalk.gray('# Quick bug fix'));
+  console.log(chalk.white('proagents fix "Login button not working"'));
+  console.log('');
+
+  // More info
+  console.log(chalk.bold.white('More Information'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log('Documentation: ' + chalk.cyan('./proagents/README.md'));
+  console.log('Full Workflow: ' + chalk.cyan('./proagents/WORKFLOW.md'));
+  console.log('GitHub: ' + chalk.cyan('https://github.com/prakashpro3/proAgents'));
+  console.log('');
+}

package/lib/commands/init.js

@@ -0,0 +1,64 @@
+import { existsSync, mkdirSync, cpSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * Initialize ProAgents in the current project
+ */
+export async function initCommand(options = {}) {
+  const targetDir = process.cwd();
+  const proagentsDir = join(targetDir, 'proagents');
+  const sourceDir = join(__dirname, '..', '..', 'proagents');
+
+  console.log('\n' + chalk.bold.blue('ProAgents Initialization'));
+  console.log(chalk.blue('========================\n'));
+
+  // Check if already initialized
+  if (existsSync(proagentsDir) && !options.force) {
+    console.log(chalk.yellow('⚠️  ProAgents is already initialized in this project.'));
+    console.log(chalk.gray('   Use --force to overwrite.\n'));
+    return;
+  }
+
+  try {
+    // Copy proagents folder
+    console.log(chalk.gray('Copying framework files...'));
+    cpSync(sourceDir, proagentsDir, { recursive: true, force: options.force || false });
+    console.log(chalk.green('✓ Framework files copied to ./proagents/'));
+
+    // Create config if not skipped
+    if (!options.skipConfig) {
+      const configPath = join(targetDir, 'proagents.config.yaml');
+      if (!existsSync(configPath)) {
+        const configSource = join(sourceDir, 'proagents.config.yaml');
+        if (existsSync(configSource)) {
+          cpSync(configSource, configPath);
+          console.log(chalk.green('✓ Created proagents.config.yaml'));
+        }
+      }
+    }
+
+    // Success message
+    console.log(chalk.green('\n✓ ProAgents initialized successfully!\n'));
+
+    // Next steps
+    console.log(chalk.bold('Next Steps:'));
+    console.log(chalk.white('───────────'));
+    console.log('1. Open your AI assistant (Claude, ChatGPT, Cursor, etc.)');
+    console.log('2. Start a feature:');
+    console.log(chalk.cyan('   /feature-start "your feature name"'));
+    console.log('3. Or use the CLI:');
+    console.log(chalk.cyan('   proagents feature start "your feature name"'));
+    console.log('\n' + chalk.gray('Documentation: ./proagents/README.md'));
+    console.log(chalk.gray('Full Workflow: ./proagents/WORKFLOW.md\n'));
+
+  } catch (error) {
+    console.error(chalk.red('\n✗ Error initializing ProAgents:'));
+    console.error(chalk.red(error.message));
+    process.exit(1);
+  }
+}