proagents 1.0.0 → 1.0.2

package/README.md

@@ -48,7 +48,7 @@ proagents feature start "Add user authentication"
 
 **Using AI assistant (Claude, ChatGPT, etc.):**
 ```
-/feature-start "Add user authentication"
+pa:feature "Add user authentication"
 ```
 
 ### 3. Follow the guided workflow
@@ -91,21 +91,21 @@ proagents commands                  # Show all commands
 
 ---
 
-## Slash Commands
+## Commands
 
-Type `/` in your AI assistant to see available commands:
+Type `pa:` in your AI assistant to use ProAgents 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 |
+| `pa:init` | Initialize ProAgents in your project |
+| `pa:feature` | Start a new feature |
+| `pa:fix` | Quick bug fix mode |
+| `pa:doc` | Generate documentation |
+| `pa:qa` | Quality assurance checks |
+| `pa:test` | Run test workflows |
+| `pa:deploy` | Deployment preparation |
+| `pa:status` | Check current status |
+| `pa:help` | Show all commands |
 
 ---
 

package/lib/commands/init.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, cpSync } from 'fs';
+import { existsSync, mkdirSync, cpSync, writeFileSync, readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import chalk from 'chalk';
@@ -42,19 +42,130 @@ export async function initCommand(options = {}) {
       }
     }
 
+    // Create docs folder structure for client-facing documentation
+    const docsDir = join(targetDir, 'docs');
+    const releasesDir = join(docsDir, 'releases');
+    const apiDocsDir = join(docsDir, 'api');
+
+    if (!existsSync(docsDir)) {
+      mkdirSync(docsDir, { recursive: true });
+    }
+    if (!existsSync(releasesDir)) {
+      mkdirSync(releasesDir, { recursive: true });
+      // Create releases index
+      writeFileSync(join(releasesDir, 'README.md'),
+`# Release History
+
+This folder contains version-specific release notes.
+
+| Version | Date | Description |
+|---------|------|-------------|
+| v1.0.0 | TBD | Initial release |
+
+---
+
+Generated by [ProAgents](https://github.com/prakashpro3/proAgents)
+`);
+    }
+    if (!existsSync(apiDocsDir)) {
+      mkdirSync(apiDocsDir, { recursive: true });
+    }
+    console.log(chalk.green('✓ Created docs/ folder structure'));
+
+    // Create placeholder CHANGELOG.md if not exists
+    const changelogPath = join(targetDir, 'CHANGELOG.md');
+    if (!existsSync(changelogPath)) {
+      writeFileSync(changelogPath,
+`# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial project setup
+
+---
+
+*Generated by [ProAgents](https://github.com/prakashpro3/proAgents)*
+`);
+      console.log(chalk.green('✓ Created CHANGELOG.md'));
+    }
+
+    // Create placeholder RELEASE_NOTES.md if not exists
+    const releaseNotesPath = join(targetDir, 'RELEASE_NOTES.md');
+    if (!existsSync(releaseNotesPath)) {
+      writeFileSync(releaseNotesPath,
+`# Release Notes
+
+**Current Version:** Unreleased
+**Last Updated:** ${new Date().toISOString().split('T')[0]}
+
+## Overview
+
+This document contains release notes for client and stakeholder communication.
+
+## Latest Release
+
+No releases yet. Use \`pa:release\` to generate release notes.
+
+---
+
+*Generated by [ProAgents](https://github.com/prakashpro3/proAgents)*
+`);
+      console.log(chalk.green('✓ Created RELEASE_NOTES.md'));
+    }
+
+    // Add ProAgents section to README.md (AI tools auto-read this)
+    const readmePath = join(targetDir, 'README.md');
+    const proagentsSection = `
+<!-- PROAGENTS:START - AI Development Commands -->
+## AI Commands (ProAgents)
+
+This project uses [ProAgents](https://github.com/prakashpro3/proAgents). Commands use \`pa:\` prefix:
+
+| Command | Description |
+|---------|-------------|
+| \`pa:help\` | Show all commands |
+| \`pa:feature "name"\` | Start new feature |
+| \`pa:fix "bug"\` | Quick bug fix |
+| \`pa:status\` | Show progress |
+| \`pa:release\` | Generate release notes |
+
+For detailed commands, see \`./proagents/PROAGENTS.md\`
+<!-- PROAGENTS:END -->
+
+`;
+
+    if (existsSync(readmePath)) {
+      const readmeContent = readFileSync(readmePath, 'utf-8');
+      if (!readmeContent.includes('PROAGENTS:START')) {
+        // Prepend to existing README
+        writeFileSync(readmePath, proagentsSection + readmeContent);
+        console.log(chalk.green('✓ Added ProAgents commands to README.md'));
+      }
+    } else {
+      // Create new README with ProAgents section
+      writeFileSync(readmePath, proagentsSection + `# Project Name\n\nProject description.\n`);
+      console.log(chalk.green('✓ Created README.md with ProAgents commands'));
+    }
+
     // 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'));
+    // Simple next steps
+    console.log(chalk.bold('Usage:'));
+    console.log(chalk.white('──────'));
+    console.log('Type commands in any AI (prefix: pa:)');
+    console.log(chalk.cyan('  pa:help              ') + chalk.gray('Show all commands'));
+    console.log(chalk.cyan('  pa:feature "name"    ') + chalk.gray('Start new feature'));
+    console.log(chalk.cyan('  pa:fix "bug"         ') + chalk.gray('Quick bug fix'));
+    console.log(chalk.cyan('  pa:status            ') + chalk.gray('Show progress'));
+    console.log(chalk.cyan('  pa:release           ') + chalk.gray('Generate release notes'));
+    console.log('\n' + chalk.gray('Commands added to README.md - AI tools will see them automatically.\n'));
 
   } catch (error) {
     console.error(chalk.red('\n✗ Error initializing ProAgents:'));

package/package.json

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

package/proagents/PROAGENTS.md

@@ -0,0 +1,54 @@
+# ProAgents Commands
+
+Execute these commands when user types them (prefix: `pa:`):
+
+## Commands
+
+| Command | What to Do |
+|---------|------------|
+| `pa:help` | Show this command table |
+| `pa:feature "name"` | Create `./proagents/active-features/feature-[name]/`, analyze codebase, implement feature |
+| `pa:fix "description"` | Find bug, fix it, update `./CHANGELOG.md` |
+| `pa:status` | Read `./proagents/active-features/*/status.json`, show progress |
+| `pa:qa` | Check code quality, run tests, report issues |
+| `pa:test` | Create/run tests for current work |
+| `pa:doc` | Generate documentation |
+| `pa:release` | Generate release notes → `./RELEASE_NOTES.md` |
+| `pa:changelog` | Update `./CHANGELOG.md` |
+
+## Feature Workflow
+
+`pa:feature` follows these phases:
+1. **Init** → Create tracking files
+2. **Analysis** → Understand existing code
+3. **Requirements** → Define what to build
+4. **Design** → Plan architecture
+5. **Implementation** → Write code
+6. **Testing** → Create tests
+7. **Review** → Quality check
+8. **Documentation** → Update docs
+9. **Deploy** → Prepare release
+
+## Save Locations
+
+| Document | Location |
+|----------|----------|
+| Changelog | `./CHANGELOG.md` |
+| Release Notes | `./RELEASE_NOTES.md` |
+| Feature Status | `./proagents/active-features/` |
+
+## Examples
+
+```
+User: pa:feature "add user login"
+→ Create feature, analyze codebase, guide implementation
+
+User: pa:fix "submit button not working"
+→ Find issue, fix it, update changelog
+
+User: pa:status
+→ Show active features and progress
+
+User: pa:help
+→ Show all available commands
+```

package/proagents/README.md

@@ -9,8 +9,8 @@ A portable, AI-agnostic development workflow framework that automates the full s
 ### 1. Initialize in Your Project
 
 ```bash
-# Using slash command (any AI)
-/init
+# Using pa: command (any AI)
+pa:init
 
 # Or CLI
 npx proagents init
@@ -19,8 +19,8 @@ npx proagents init
 ### 2. Start Your First Feature
 
 ```bash
-# Using slash command
-/feature-start "Add user authentication"
+# Using pa: command
+pa:feature "Add user authentication"
 
 # Or CLI
 proagents feature start "Add user authentication"
@@ -48,23 +48,23 @@ The AI will guide you through:
 | **IDE Agnostic** | VS Code, JetBrains, Vim, any editor |
 | **Self-Learning** | Learns from your usage and adapts |
 | **Flexible Entry** | Full workflow, Bug Fix, or Quick Change modes |
-| **Slash Commands** | `/doc`, `/qa`, `/test`, `/deploy` with hints |
+| **Commands** | `pa:doc`, `pa:qa`, `pa:test`, `pa:deploy` with hints |
 
-## Slash Commands
+## Commands
 
-Type `/` to see available commands:
+Type `pa:` followed by a command:
 
 | Command | Description |
 |---------|-------------|
-| `/init` | Initialize ProAgents |
-| `/feature-start` | Start new feature |
-| `/fix-quick` | Quick bug fix |
-| `/doc` | Generate documentation |
-| `/qa` | Quality assurance |
-| `/test` | Run tests |
-| `/deploy` | Deploy workflow |
-| `/status` | Check status |
-| `/help` | Show all commands |
+| `pa:init` | Initialize ProAgents |
+| `pa:feature` | Start new feature |
+| `pa:fix-quick` | Quick bug fix |
+| `pa:doc` | Generate documentation |
+| `pa:qa` | Quality assurance |
+| `pa:test` | Run tests |
+| `pa:deploy` | Deploy workflow |
+| `pa:status` | Check status |
+| `pa:help` | Show all commands |
 
 ## Configuration
 
@@ -85,7 +85,7 @@ git:
 
 - [Complete Workflow Guide](./WORKFLOW.md)
 - [Configuration Reference](./proagents.config.yaml)
-- [Slash Commands](./prompts/00-init.md)
+- [Commands](./prompts/00-init.md)
 - [UI Integration](./ui-integration/)
 - [Examples](./examples/)