proagents 1.0.0 → 1.0.1

package/proagents/learning/reports.md

@@ -224,12 +224,12 @@ reports:
 ### On-Demand Reports
 
 ```bash
-# Generate reports via slash commands
-/report-learning weekly
-/report-learning monthly
-/report-learning patterns
-/report-learning decisions
-/report-learning all
+# Generate reports via commands
+pa:report-learning weekly
+pa:report-learning monthly
+pa:report-learning patterns
+pa:report-learning decisions
+pa:report-learning all
 ```
 
 ---
@@ -279,7 +279,7 @@ Reports include actionable insights:
 │                                                                 │
 │ 1. Consider disabling "after_testing" checkpoint               │
 │    → You've skipped it 95% of the time                        │
-│    → Run: /config set checkpoints.after_testing false         │
+│    → Run: pa:config set checkpoints.after_testing false       │
 │                                                                 │
 │ 2. Document your preferred caching strategy                    │
 │    → Only 45% confidence, frequently corrected                │
@@ -294,13 +294,13 @@ Reports include actionable insights:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/report-learning` | Show learning summary |
-| `/report-learning weekly` | Generate weekly report |
-| `/report-learning monthly` | Generate monthly report |
-| `/report-patterns` | Pattern confidence report |
-| `/report-decisions` | Decision accuracy report |
-| `/report-export [format]` | Export reports |
+| `pa:report-learning` | Show learning summary |
+| `pa:report-learning weekly` | Generate weekly report |
+| `pa:report-learning monthly` | Generate monthly report |
+| `pa:report-patterns` | Pattern confidence report |
+| `pa:report-decisions` | Decision accuracy report |
+| `pa:report-export [format]` | Export reports |

package/proagents/metrics/README.md

@@ -53,18 +53,18 @@ metrics:
 
 ```bash
 # View current metrics dashboard
-/metrics dashboard
+pa:metrics dashboard
 
 # Generate weekly report
-/metrics report --period weekly
+pa:metrics report --period weekly
 
 # View specific category
-/metrics productivity
-/metrics quality
-/metrics deployment
+pa:metrics productivity
+pa:metrics quality
+pa:metrics deployment
 
 # Export metrics
-/metrics export --format json --output ./metrics.json
+pa:metrics export --format json --output ./metrics.json
 ```
 
 ---

package/proagents/metrics/code-quality-kpis.md

@@ -409,22 +409,22 @@ Top Improvement Areas:
 
 ```bash
 # View quality dashboard
-/metrics quality
+pa:metrics quality
 
 # Detailed coverage report
-/metrics coverage --detailed
+pa:metrics coverage --detailed
 
 # Complexity hotspots
-/metrics complexity --hotspots
+pa:metrics complexity --hotspots
 
 # Technical debt breakdown
-/metrics debt --by-category
+pa:metrics debt --by-category
 
 # Dependency audit
-/metrics dependencies --audit
+pa:metrics dependencies --audit
 
 # Generate quality report
-/metrics quality --report --format pdf
+pa:metrics quality --report --format pdf
 ```
 
 ---

package/proagents/metrics/deployment-metrics.md

@@ -466,22 +466,22 @@ metrics:
 
 ```bash
 # View DORA dashboard
-/metrics dora
+pa:metrics dora
 
 # Deployment frequency
-/metrics deployments --frequency
+pa:metrics deployments --frequency
 
 # Lead time analysis
-/metrics deployments --lead-time
+pa:metrics deployments --lead-time
 
 # Failure rate
-/metrics deployments --failures
+pa:metrics deployments --failures
 
 # MTTR analysis
-/metrics deployments --mttr
+pa:metrics deployments --mttr
 
 # Generate DORA report
-/metrics dora --report --period quarterly
+pa:metrics dora --report --period quarterly
 ```
 
 ---

package/proagents/metrics/developer-productivity.md

@@ -352,17 +352,17 @@ async function collectIssueMetrics(project: string): Promise<IssueMetrics> {
 
 ```bash
 # View productivity dashboard
-/metrics productivity
+pa:metrics productivity
 
 # Analyze specific period
-/metrics productivity --from 2024-01-01 --to 2024-01-31
+pa:metrics productivity --from 2024-01-01 --to 2024-01-31
 
 # Compare periods
-/metrics productivity --compare "this-sprint" "last-sprint"
+pa:metrics productivity --compare "this-sprint" "last-sprint"
 
 # Export data
-/metrics productivity --export json
+pa:metrics productivity --export json
 
 # View individual metrics
-/metrics productivity --developer @alice
+pa:metrics productivity --developer @alice
 ```

package/proagents/metrics/learning-effectiveness.md

@@ -427,22 +427,22 @@ metrics:
 
 ```bash
 # View learning dashboard
-/metrics learning
+pa:metrics learning
 
 # Adoption analysis
-/metrics learning --adoption
+pa:metrics learning --adoption
 
 # Pattern accuracy
-/metrics learning --patterns
+pa:metrics learning --patterns
 
 # Suggestion stats
-/metrics learning --suggestions
+pa:metrics learning --suggestions
 
 # Time savings report
-/metrics learning --savings
+pa:metrics learning --savings
 
 # Generate learning report
-/metrics learning --report
+pa:metrics learning --report
 ```
 
 ---

package/proagents/migrations/from-claude-projects.md

@@ -228,29 +228,30 @@ learning:
 - Write tests for this
 ```
 
-**To ProAgents Slash Commands:**
+**To ProAgents Commands:**
 
 **`proagents/slash-commands.json`:**
 ```json
 {
+  "prefix": "pa:",
   "commands": [
     {
-      "name": "/feature",
+      "name": "pa:feature",
       "description": "Start new feature development",
       "prompt": "Start a new feature workflow"
     },
     {
-      "name": "/review",
+      "name": "pa:review",
       "description": "Code review assistance",
       "prompt": "Review the current code changes"
     },
     {
-      "name": "/debug",
+      "name": "pa:debug",
       "description": "Debug an issue",
       "prompt": "Help debug the following issue"
     },
     {
-      "name": "/test",
+      "name": "pa:test",
       "description": "Generate tests",
       "prompt": "Generate tests for the current code"
     }
@@ -296,7 +297,7 @@ proagents export --format claude-project > claude-instructions.md
 - [ ] Migrate coding standards
 - [ ] Migrate architecture patterns
 - [ ] Set up workflow prompts
-- [ ] Configure slash commands
+- [ ] Configure commands
 - [ ] Test with a small feature
 - [ ] Set up MCP integration (optional)
 

package/proagents/migrations/from-cursor-rules.md

@@ -39,7 +39,7 @@ Review your `.cursorrules` content and identify:
 1. **Coding Standards** - Style, naming, formatting rules
 2. **Project Patterns** - Architecture, state management, etc.
 3. **Instructions** - How AI should behave
-4. **Custom Commands** - Slash commands or workflows
+4. **Custom Commands** - Commands or workflows
 
 ### Step 2: Create Standards Files
 

package/proagents/notifications/templates.md

@@ -367,7 +367,7 @@ notifications:
 
     # Override specific templates
     overrides:
-      feature.completed: "./templates/feature-completed.json"
+      feature.completed: "./templatespa:feature-completed.json"
       deploy.failed: "./templates/deploy-failed.json"
 
     # Template directory
@@ -381,11 +381,11 @@ notifications:
   templates:
     channels:
       slack:
-        feature.completed: "./templates/slack/feature-completed.json"
+        feature.completed: "./templates/slackpa:feature-completed.json"
         deploy.failed: "./templates/slack/deploy-failed.json"
 
       email:
-        feature.completed: "./templates/email/feature-completed.html"
+        feature.completed: "./templates/emailpa:feature-completed.html"
         weekly_digest: "./templates/email/weekly-digest.html"
 
       # Discord uses default templates

package/proagents/parallel-features/README.md

@@ -75,11 +75,11 @@ parallel_features:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/conflict-check` | Check for conflicts |
-| `/conflict-status` | View conflict dashboard |
-| `/feature-deps` | View feature dependencies |
-| `/merge-order` | Get recommended merge order |
+| `pa:conflict-check` | Check for conflicts |
+| `pa:conflict-status` | View conflict dashboard |
+| `pa:feature-deps` | View feature dependencies |
+| `pa:merge-order` | Get recommended merge order |

package/proagents/parallel-features/conflict-detection.md

@@ -50,7 +50,7 @@ Beyond file-level, detect:
 Before starting a new feature:
 
 ```
-/conflict-check "feature-name"
+pa:conflict-check "feature-name"
 
 Output:
 Feature: user-profile
@@ -90,7 +90,7 @@ Track file modifications:
 ### 3. Pre-Merge Check
 
 ```
-/conflict-check-merge "feature-name"
+pa:conflict-check-merge "feature-name"
 
 Checking feature-user-profile for merge conflicts...
 
@@ -217,10 +217,10 @@ parallel_features:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/conflict-check` | Check for conflicts |
-| `/conflict-status` | Show conflict status |
-| `/conflict-resolve` | Help resolve conflicts |
+| `pa:conflict-check` | Check for conflicts |
+| `pa:conflict-status` | Show conflict status |
+| `pa:conflict-resolve` | Help resolve conflicts |

package/proagents/parallel-features/dependency-management.md

@@ -380,13 +380,13 @@ dependencies:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/deps` | View dependency graph |
-| `/deps [feature]` | View feature dependencies |
-| `/deps --blocked` | List blocked features |
-| `/deps --add [from] [to]` | Add dependency |
-| `/deps --remove [from] [to]` | Remove dependency |
-| `/deps --check` | Check for issues |
+| `pa:deps` | View dependency graph |
+| `pa:deps [feature]` | View feature dependencies |
+| `pa:deps --blocked` | List blocked features |
+| `pa:deps --add [from] [to]` | Add dependency |
+| `pa:deps --remove [from] [to]` | Remove dependency |
+| `pa:deps --check` | Check for issues |

package/proagents/parallel-features/merge-coordination.md

@@ -218,7 +218,7 @@ merge_workflow:
   phases:
     pre_merge:
       - name: "Conflict Check"
-        command: "/merge-check [feature]"
+        command: "pa:merge-check [feature]"
         required: true
 
       - name: "Test Verification"
@@ -494,13 +494,13 @@ merge:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/merge-order` | View recommended merge order |
-| `/merge-check [feature]` | Pre-merge conflict check |
-| `/merge [feature]` | Start merge process |
-| `/merge-batch` | Merge all ready features |
-| `/merge-status` | View merge progress |
-| `/merge-schedule` | View/set merge schedule |
+| `pa:merge-order` | View recommended merge order |
+| `pa:merge-check [feature]` | Pre-merge conflict check |
+| `pa:merge [feature]` | Start merge process |
+| `pa:merge-batch` | Merge all ready features |
+| `pa:merge-status` | View merge progress |
+| `pa:merge-schedule` | View/set merge schedule |

package/proagents/parallel-features/tracking-system.md

@@ -404,13 +404,13 @@ tracking:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/feature-status` | View all features status |
-| `/feature-status [id]` | View specific feature |
-| `/feature-update [id]` | Update feature status |
-| `/feature-block [id]` | Mark feature as blocked |
-| `/feature-unblock [id]` | Remove blocker |
-| `/feature-dashboard` | View dashboard |
+| `pa:feature-status` | View all features status |
+| `pa:feature-status [id]` | View specific feature |
+| `pa:feature-update [id]` | Update feature status |
+| `pa:feature-block [id]` | Mark feature as blocked |
+| `pa:feature-unblock [id]` | Remove blocker |
+| `pa:feature-dashboard` | View dashboard |

package/proagents/performance/bundle-analysis.md

@@ -366,10 +366,10 @@ jobs:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/bundle-analyze` | Analyze bundle |
-| `/bundle-report` | Generate report |
-| `/bundle-optimize` | Optimization suggestions |
+| `pa:bundle-analyze` | Analyze bundle |
+| `pa:bundle-report` | Generate report |
+| `pa:bundle-optimize` | Optimization suggestions |

package/proagents/performance/load-testing.md

@@ -551,13 +551,13 @@ performance:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/load-test` | Run default load test |
-| `/load-test --smoke` | Run smoke test |
-| `/load-test --stress` | Run stress test |
-| `/load-test --spike` | Run spike test |
-| `/load-test --soak` | Run soak test |
-| `/load-test --report` | Generate test report |
+| `pa:load-test` | Run default load test |
+| `pa:load-test --smoke` | Run smoke test |
+| `pa:load-test --stress` | Run stress test |
+| `pa:load-test --spike` | Run spike test |
+| `pa:load-test --soak` | Run soak test |
+| `pa:load-test --report` | Generate test report |

package/proagents/performance/runtime-metrics.md

@@ -478,12 +478,12 @@ performance:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/perf-metrics` | View current metrics |
-| `/perf-metrics --endpoint [path]` | Metrics for specific endpoint |
-| `/perf-metrics --baseline` | Compare to baseline |
-| `/perf-metrics --slow` | List slow endpoints |
-| `/perf-metrics --alerts` | View active alerts |
+| `pa:perf-metrics` | View current metrics |
+| `pa:perf-metrics --endpoint [path]` | Metrics for specific endpoint |
+| `pa:perf-metrics --baseline` | Compare to baseline |
+| `pa:perf-metrics --slow` | List slow endpoints |
+| `pa:perf-metrics --alerts` | View active alerts |

package/proagents/performance/web-vitals.md

@@ -414,12 +414,12 @@ jobs:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/perf-vitals` | Check Web Vitals |
-| `/perf-lcp` | Analyze LCP |
-| `/perf-cls` | Analyze CLS |
-| `/perf-fid` | Analyze FID |
-| `/perf-report` | Generate performance report |
+| `pa:perf-vitals` | Check Web Vitals |
+| `pa:perf-lcp` | Analyze LCP |
+| `pa:perf-cls` | Analyze CLS |
+| `pa:perf-fid` | Analyze FID |
+| `pa:perf-report` | Generate performance report |

package/proagents/plugins/README.md

@@ -10,7 +10,7 @@ ProAgents supports a plugin architecture that allows you to:
 
 - Add custom workflow phases
 - Integrate with external tools
-- Create custom slash commands
+- Create custom commands
 - Add new code generators
 - Implement custom validators
 - Extend reporting capabilities

package/proagents/plugins/creating-plugins.md

@@ -184,7 +184,7 @@ export default class CustomGeneratorPlugin implements Plugin<GeneratorPluginConf
       generator: new MyComponentGenerator(config.templatesDir),
     });
 
-    // Register slash command
+    // Register command
     context.commands.registerSlash({
       name: '/generate-component',
       description: 'Generate a custom component',

package/proagents/plugins/plugin-api.md

@@ -310,10 +310,10 @@ context.commands.register({
   },
 });
 
-// Slash command
+// Command
 context.commands.registerSlash({
   name: '/my-command',
-  description: 'My slash command',
+  description: 'My command',
   handler: async (input) => {
     return { response: 'Command executed' };
   },

package/proagents/plugins/plugin-registry.md

@@ -110,9 +110,9 @@ plugins:
 ```
 
 **Commands:**
-- `/jira link <ticket-id>` - Link feature to existing ticket
-- `/jira status` - Show linked ticket status
-- `/jira comment <message>` - Add comment to ticket
+- `pa:jira link <ticket-id>` - Link feature to existing ticket
+- `pa:jira status` - Show linked ticket status
+- `pa:jira comment <message>` - Add comment to ticket
 
 ---
 

package/proagents/proagents.config.yaml

@@ -49,12 +49,35 @@ parallel_features:
 documentation:
   default_mode: "moderate"  # full | moderate | lite
   default_scope: "project"
+
+  # Output locations for different document types
   output:
     format: "markdown"
-    directory: "./docs"
     include_diagrams: true
+
+    # Client-facing docs (at project root for easy sharing)
+    client_facing:
+      changelog: "./CHANGELOG.md"           # Project changelog
+      release_notes: "./RELEASE_NOTES.md"   # Current release summary
+      readme: "./README.md"                 # Project README
+      releases_dir: "./docs/releases/"      # Version-specific release notes
+      api_docs: "./docs/api/"               # Public API documentation
+
+    # Internal development docs (inside proagents/)
+    internal:
+      feature_docs: "./proagents/active-features/"  # Feature-specific docs
+      dev_changelog: "./proagents/changelog/"       # Detailed dev notes
+      analysis: "./proagents/cache/"                # Codebase analysis
+      learning: "./proagents/.learning/"            # AI learning data
+
   required_for_all_modes: true
 
+  # Auto-generate settings
+  auto_generate:
+    release_notes_on_deploy: true
+    changelog_on_feature_complete: true
+    update_readme_on_major_changes: false
+
 # AI Model Configuration
 ai:
   default_model: "auto"  # auto | claude-3-opus | gpt-4 | etc.
@@ -192,20 +215,20 @@ approvals:
     production:
       required: true
 
-# Custom Slash Commands
+# Custom Commands
 custom_commands:
-  "/ship":
+  "pa:ship":
     description: "Full deployment workflow"
     steps:
-      - "/test-all"
-      - "/qa-full"
-      - "/deploy-prod"
+      - "pa:test-all"
+      - "pa:qa-full"
+      - "pa:deploy-prod"
 
-  "/morning":
+  "pa:morning":
     description: "Daily start routine"
     steps:
-      - "/status"
-      - "/feature-list"
+      - "pa:status"
+      - "pa:feature-list"
 
 # Standards (extend or override)
 # extends:

package/proagents/prompts/00-init-wizard.md

@@ -6,7 +6,7 @@ Interactive project setup with project type selection.
 
 ## Trigger
 
-User runs `/init` or starts a new project conversation.
+User runs `pa:init` or starts a new project conversation.
 
 ---
 
@@ -367,21 +367,21 @@ For experienced users who want to skip the wizard:
 
 ```bash
 # Full wizard (default)
-/init
+pa:init
 
 # Quick init with type
-/init --type web-frontend
-/init --type mobile --framework react-native
-/init --type backend --framework nestjs
+pa:init --type web-frontend
+pa:init --type mobile --framework react-native
+pa:init --type backend --framework nestjs
 
 # Use existing config
-/init --config ./proagents.config.yaml
+pa:init --config ./proagents.config.yaml
 
 # Minimal setup (prompts only essential questions)
-/init --quick
+pa:init --quick
 
 # Skip all prompts, use all defaults
-/init --yes
+pa:init --yes
 ```
 
 ---
@@ -396,12 +396,12 @@ ProAgents initialized successfully!
 
 Next steps:
 1. Review proagents.config.yaml
-2. Start your first feature: /feature-start "Feature name"
-3. Need help? Run /help
+2. Start your first feature: pa:feature "Feature name"
+3. Need help? Run pa:help
 
 Your project type: Web Frontend (React)
 Recommended workflow:
-  /feature-start → /analyze → Design → /implement → /test → /deploy
+  pa:feature → pa:analyze → Design → pa:implement → pa:test → pa:deploy
 ```
 
 2. **Create initial files:**
@@ -414,13 +414,13 @@ Recommended workflow:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/init` | Full initialization wizard |
-| `/init --type [type]` | Quick init with project type |
-| `/init --wizard` | Force full wizard |
-| `/init --quick` | Minimal setup |
-| `/init --config [file]` | Use existing config |
-| `/setup` | Re-run setup for existing project |
+| `pa:init` | Full initialization wizard |
+| `pa:init --type [type]` | Quick init with project type |
+| `pa:init --wizard` | Force full wizard |
+| `pa:init --quick` | Minimal setup |
+| `pa:init --config [file]` | Use existing config |
+| `pa:setup` | Re-run setup for existing project |