proagents 1.0.0 → 1.0.2

package/proagents/prompts/07-documentation.md

@@ -7,16 +7,16 @@ Universal prompts for creating comprehensive documentation.
 ## Quick Start
 
 ```
-/doc
+pa:doc
 ```
 
 Related commands:
-- `/doc-full` - Full in-depth documentation
-- `/doc-moderate` - Balanced documentation
-- `/doc-lite` - Quick reference docs
-- `/doc-module [name]` - Document specific module
-- `/doc-file [path]` - Document specific file
-- `/doc-api` - API documentation
+- `pa:doc-full` - Full in-depth documentation
+- `pa:doc-moderate` - Balanced documentation
+- `pa:doc-lite` - Quick reference docs
+- `pa:doc-module [name]` - Document specific module
+- `pa:doc-file [path]` - Document specific file
+- `pa:doc-api` - API documentation
 
 ---
 
@@ -431,6 +431,8 @@ Generate changelog entry for: [VERSION]
 Changes made:
 [LIST OF CHANGES]
 
+OUTPUT LOCATION: ./CHANGELOG.md (project root - client-facing)
+
 Format:
 ```markdown
 ## [Version] - [Date]
@@ -460,6 +462,110 @@ Format:
 
 ---
 
+## Release Notes (Client-Facing)
+
+### Generate Release Notes
+
+```
+Generate release notes for: [VERSION]
+
+OUTPUT LOCATION: ./RELEASE_NOTES.md (project root - for client sharing)
+ALSO SAVE TO: ./docs/releases/v[VERSION].md (version archive)
+
+```markdown
+# Release Notes - v[VERSION]
+
+**Release Date:** [DATE]
+
+## Overview
+
+[2-3 sentence summary of this release for clients/stakeholders]
+
+## What's New
+
+### [Feature 1 Name]
+[Client-friendly description of the feature and its benefits]
+
+### [Feature 2 Name]
+[Client-friendly description]
+
+## Improvements
+
+- [Improvement 1 - user-facing benefit]
+- [Improvement 2 - user-facing benefit]
+
+## Bug Fixes
+
+- Fixed [issue description in user terms]
+- Resolved [issue description in user terms]
+
+## Breaking Changes
+
+⚠️ [Any breaking changes that affect users - if none, omit section]
+
+## Upgrade Instructions
+
+[Steps to upgrade from previous version - if needed]
+
+## Known Issues
+
+[Any known issues in this release - if none, omit section]
+
+---
+
+For technical details, see [CHANGELOG.md](./CHANGELOG.md)
+For support, contact [support email/link]
+```
+```
+
+### Generate Version-Specific Release Notes
+
+```
+Generate detailed release notes for version [VERSION]
+
+Save to: ./docs/releases/v[VERSION].md
+
+Include:
+1. Executive summary (for stakeholders)
+2. New features with screenshots/examples
+3. Performance improvements with metrics
+4. Security updates
+5. Migration guide (if breaking changes)
+6. Known issues and workarounds
+7. Upcoming features preview
+```
+
+### Generate Release Announcement
+
+```
+Generate release announcement for: [VERSION]
+
+Use for: Email, Slack, Social media
+
+Format:
+```markdown
+# 🚀 [Product Name] v[VERSION] Released!
+
+[One compelling sentence about the release]
+
+## Highlights
+
+✨ [Feature 1] - [One line benefit]
+✨ [Feature 2] - [One line benefit]
+🐛 [Key fix] - [One line description]
+
+## Quick Links
+
+- 📖 [Full Release Notes](./RELEASE_NOTES.md)
+- 📦 [Download/Install](#)
+- 📚 [Documentation](#)
+
+[Call to action]
+```
+```
+
+---
+
 ## Architecture Documentation
 
 ### Document Architecture
@@ -658,16 +764,32 @@ MAINTENANCE:
 
 ---
 
-## Slash Commands Reference
-
-| Command | Description |
-|---------|-------------|
-| `/doc` | Show documentation options |
-| `/doc-full` | Full documentation |
-| `/doc-moderate` | Balanced documentation |
-| `/doc-lite` | Quick reference |
-| `/doc-module [name]` | Document module |
-| `/doc-file [path]` | Document file |
-| `/doc-api` | API documentation |
-| `/doc-readme` | Generate README |
-| `/doc-changelog` | Update changelog |
+## Output Locations Summary
+
+| Document Type | Location | Audience |
+|---------------|----------|----------|
+| Release Notes | `./RELEASE_NOTES.md` | Clients/Stakeholders |
+| Changelog | `./CHANGELOG.md` | Clients/Public |
+| Version Archive | `./docs/releases/v*.md` | Clients |
+| API Docs | `./docs/api/` | Developers/Clients |
+| README | `./README.md` | Public |
+| Dev Changelog | `proagents/changelog/` | Internal Team |
+| Feature Docs | `proagents/active-features/` | Internal Team |
+
+---
+
+## Commands Reference
+
+| Command | Description | Output Location |
+|---------|-------------|-----------------|
+| `pa:doc` | Show documentation options | - |
+| `pa:doc-full` | Full documentation | `./docs/` |
+| `pa:doc-moderate` | Balanced documentation | `./docs/` |
+| `pa:doc-lite` | Quick reference | `./docs/` |
+| `pa:doc-module [name]` | Document module | `./docs/modules/` |
+| `pa:doc-file [path]` | Document file | `./docs/` |
+| `pa:doc-api` | API documentation | `./docs/api/` |
+| `pa:readme` | Generate README | `./README.md` |
+| `pa:changelog` | Update changelog | `./CHANGELOG.md` |
+| `pa:release` | Generate release notes | `./RELEASE_NOTES.md` |
+| `pa:release [version]` | Version-specific notes | `./docs/releases/v*.md` |

package/proagents/prompts/08-deployment.md

@@ -7,13 +7,13 @@ Universal prompts for deployment preparation and execution.
 ## Quick Start
 
 ```
-/deploy
+pa:deploy
 ```
 
 Related commands:
-- `/deploy-staging` - Deploy to staging
-- `/deploy-prod` - Deploy to production
-- `/deploy-check` - Pre-deployment checks
+- `pa:deploy-staging` - Deploy to staging
+- `pa:deploy-prod` - Deploy to production
+- `pa:deploy-check` - Pre-deployment checks
 
 ---
 
@@ -526,14 +526,14 @@ AFTER:
 
 ---
 
-## Slash Commands Reference
+## Commands Reference
 
 | Command | Description |
 |---------|-------------|
-| `/deploy` | Show deployment options |
-| `/deploy-staging` | Deploy to staging |
-| `/deploy-prod` | Deploy to production |
-| `/deploy-check` | Pre-deployment checklist |
-| `/deploy-monitor` | Post-deploy monitoring |
-| `/deploy-runbook` | Generate deployment runbook |
-| `/release-notes` | Generate release notes |
+| `pa:deploy` | Show deployment options |
+| `pa:deploy-staging` | Deploy to staging |
+| `pa:deploy-prod` | Deploy to production |
+| `pa:deploy-check` | Pre-deployment checklist |
+| `pa:deploy-monitor` | Post-deploy monitoring |
+| `pa:deploy-runbook` | Generate deployment runbook |
+| `pa:release-notes` | Generate release notes |

package/proagents/prompts/09-rollback.md

@@ -7,12 +7,12 @@ Universal prompts for rollback planning and execution.
 ## Quick Start
 
 ```
-/rollback
+pa:rollback
 ```
 
 Related commands:
-- `/rollback-quick` - Quick rollback to previous version
-- `/rollback-full` - Full rollback with database revert
+- `pa:rollback-quick` - Quick rollback to previous version
+- `pa:rollback-full` - Full rollback with database revert
 
 ---
 
@@ -540,15 +540,15 @@ AFTER ROLLBACK:
 
 ---
 
-## Slash Commands Reference
+## Commands Reference
 
 | Command | Description |
 |---------|-------------|
-| `/rollback` | Show rollback options |
-| `/rollback-quick` | Quick code-only rollback |
-| `/rollback-full` | Full rollback with DB |
-| `/rollback-plan` | Create rollback plan |
-| `/rollback-verify` | Verify rollback success |
-| `/rollback-test` | Test rollback procedure |
-| `/incident-doc` | Document incident |
-| `/post-mortem` | Create post-mortem |
+| `pa:rollback` | Show rollback options |
+| `pa:rollback-quick` | Quick code-only rollback |
+| `pa:rollback-full` | Full rollback with DB |
+| `pa:rollback-plan` | Create rollback plan |
+| `pa:rollback-verify` | Verify rollback success |
+| `pa:rollback-test` | Test rollback procedure |
+| `pa:incident-doc` | Document incident |
+| `pa:post-mortem` | Create post-mortem |

package/proagents/prompts/README.md

@@ -27,12 +27,12 @@ These prompts work with any AI platform (Claude, ChatGPT, Gemini, Copilot, etc.)
 
 ## Usage
 
-### With Slash Commands
+### With Commands
 
 ```
-/init           → Uses 00-init.md
-/feature-start  → Uses full workflow
-/doc            → Uses 07-documentation.md
+pa:init      → Uses 00-init.md
+pa:feature   → Uses full workflow
+pa:doc       → Uses 07-documentation.md
 ```
 
 ### Manual Copy-Paste

package/proagents/prompts/accessibility/README.md

@@ -24,22 +24,22 @@ These prompts help ensure your application is accessible to all users, including
 
 ```bash
 # Full accessibility audit
-/a11y audit <component>
+pa:a11y audit <component>
 
 # Check WCAG compliance at specific level
-/a11y wcag AA
+pa:a11y wcag AA
 
 # Review ARIA implementation
-/a11y aria <component>
+pa:a11y aria <component>
 
 # Check keyboard navigation
-/a11y keyboard <component>
+pa:a11y keyboard <component>
 
 # Fix specific accessibility issue
-/a11y fix <issue>
+pa:a11y fix <issue>
 
 # Generate accessibility tests
-/a11y test <component>
+pa:a11y test <component>
 ```
 
 ---

package/proagents/prompts/accessibility/audit.md

@@ -204,13 +204,13 @@ function Modal({ isOpen, onClose, children }) {
 
 ```bash
 # Run accessibility audit
-/a11y audit ./src/components/Button.tsx
+pa:a11y audit ./src/components/Button.tsx
 
 # Check specific WCAG criteria
-/a11y check 1.4.3  # Color contrast
+pa:a11y check 1.4.3  # Color contrast
 
 # Generate a11y tests
-/a11y test-gen ./src/components/Form.tsx
+pa:a11y test-gen ./src/components/Form.tsx
 ```
 
 ---

package/proagents/prompts/accessibility/wcag.md

@@ -55,7 +55,7 @@ For each finding, provide:
 ### Check Component for AA Compliance
 
 ```markdown
-/a11y wcag AA
+pa:a11y wcag AA
 
 Check this button component for WCAG AA compliance:
 

package/proagents/prompts/debugging/README.md

@@ -18,10 +18,10 @@ AI-assisted debugging workflows.
 ## Quick Commands
 
 ```bash
-/debug analyze <error>     # Analyze error message
-/debug trace <issue>       # Trace issue through code
-/debug suggest <symptom>   # Get fix suggestions
-/debug test <hypothesis>   # Test a hypothesis
+pa:debug analyze <error>     # Analyze error message
+pa:debug trace <issue>       # Trace issue through code
+pa:debug suggest <symptom>   # Get fix suggestions
+pa:debug test <hypothesis>   # Test a hypothesis
 ```
 
 ---

package/proagents/prompts/debugging/performance-debug.md

@@ -365,17 +365,17 @@ function MyComponent() {
 
 ```bash
 # Profile render performance
-/perf profile --component UserList
+pa:perf profile --component UserList
 
 # Find memory leaks
-/perf memory --snapshot
+pa:perf memory --snapshot
 
 # Analyze bundle
-/perf bundle --analyze
+pa:perf bundle --analyze
 
 # Check Core Web Vitals
-/perf vitals
+pa:perf vitals
 
 # Find slow API calls
-/perf network --slow
+pa:perf network --slow
 ```

package/proagents/prompts/debugging/systematic.md

@@ -257,14 +257,14 @@ function Counter() {
 
 ```bash
 # Analyze error message
-/debug error "TypeError: Cannot read property 'name' of undefined"
+pa:debug error "TypeError: Cannot read property 'name' of undefined"
 
 # Trace execution
-/debug trace "User registration fails after email validation"
+pa:debug trace "User registration fails after email validation"
 
 # Get fix suggestions
-/debug fix "Form resets on blur"
+pa:debug fix "Form resets on blur"
 
 # Generate debugging test
-/debug test "API returns 500 on large payload"
+pa:debug test "API returns 500 on large payload"
 ```

package/proagents/prompts/performance/README.md

@@ -18,10 +18,10 @@ AI-assisted performance analysis and optimization.
 ## Quick Commands
 
 ```bash
-/perf analyze <code>       # Analyze code performance
-/perf profile <function>   # Profile function execution
-/perf optimize <target>    # Suggest optimizations
-/perf benchmark <code>     # Create benchmarks
+pa:perf analyze <code>       # Analyze code performance
+pa:perf profile <function>   # Profile function execution
+pa:perf optimize <target>    # Suggest optimizations
+pa:perf benchmark <code>     # Create benchmarks
 ```
 
 ---

package/proagents/prompts/performance/analyze.md

@@ -252,14 +252,14 @@ console.log(`A: ${timeA}ms, B: ${timeB}ms`);
 
 ```bash
 # Analyze function complexity
-/perf complexity <function>
+pa:perf complexity <function>
 
 # Find memory leaks
-/perf memory-leak <component>
+pa:perf memory-leak <component>
 
 # Suggest optimizations
-/perf optimize <code>
+pa:perf optimize <code>
 
 # Generate benchmark
-/perf benchmark <function>
+pa:perf benchmark <function>
 ```

package/proagents/prompts/refactoring/README.md

@@ -18,10 +18,10 @@ AI-assisted code refactoring workflows.
 ## Quick Commands
 
 ```bash
-/refactor identify    # Find refactoring opportunities
-/refactor plan        # Create refactoring plan
-/refactor execute     # Perform refactoring
-/refactor validate    # Verify refactoring
+pa:refactor identify    # Find refactoring opportunities
+pa:refactor plan        # Create refactoring plan
+pa:refactor execute     # Perform refactoring
+pa:refactor validate    # Verify refactoring
 ```
 
 ---

package/proagents/prompts/refactoring/code-smells.md

@@ -128,19 +128,19 @@ class EmployeeRepository { save() {} }
 
 ```bash
 # Find long methods
-/refactor smell long-methods --threshold 30
+pa:refactor smell long-methods --threshold 30
 
 # Find large files
-/refactor smell large-files --threshold 500
+pa:refactor smell large-files --threshold 500
 
 # Find duplicate code
-/refactor smell duplicates
+pa:refactor smell duplicates
 
 # Find complex functions
-/refactor smell complexity --threshold 10
+pa:refactor smell complexity --threshold 10
 
 # Full analysis
-/refactor smell all
+pa:refactor smell all
 ```
 
 ---
@@ -149,16 +149,16 @@ class EmployeeRepository { save() {} }
 
 ```bash
 # Extract long method
-/refactor extract-method {function_name}
+pa:refactor extract-method {function_name}
 
 # Split large class
-/refactor split-class {class_name}
+pa:refactor split-class {class_name}
 
 # Remove dead code
-/refactor remove-dead-code
+pa:refactor remove-dead-code
 
 # Inline trivial methods
-/refactor inline-trivial
+pa:refactor inline-trivial
 ```
 
 ---

package/proagents/prompts/refactoring/patterns.md

@@ -472,22 +472,22 @@ function processPayment(order, payment) {
 
 ```bash
 # Apply specific refactoring pattern
-/refactor apply extract-method --function processOrder
+pa:refactor apply extract-method --function processOrder
 
 # Apply polymorphism
-/refactor apply polymorphism --switch-statement line:45
+pa:refactor apply polymorphism --switch-statement line:45
 
 # Extract class
-/refactor apply extract-class --class User --extract Profile,Auth
+pa:refactor apply extract-class --class User --extract Profile,Auth
 
 # Replace magic numbers
-/refactor apply constants --file config.ts
+pa:refactor apply constants --file config.ts
 
 # Introduce parameter object
-/refactor apply param-object --function createUser
+pa:refactor apply param-object --function createUser
 
 # Flatten conditionals
-/refactor apply guard-clauses --function processPayment
+pa:refactor apply guard-clauses --function processPayment
 ```
 
 ---

package/proagents/prompts/security-audit/README.md

@@ -26,22 +26,22 @@ These prompts help identify and fix security vulnerabilities in your code. ProAg
 
 ```bash
 # Full security audit
-/security audit <file_or_directory>
+pa:security audit <file_or_directory>
 
 # OWASP Top 10 check
-/security owasp <code>
+pa:security owasp <code>
 
 # Find hardcoded secrets
-/security secrets <path>
+pa:security secrets <path>
 
 # Check dependency vulnerabilities
-/security deps
+pa:security deps
 
 # Review authentication code
-/security auth <file>
+pa:security auth <file>
 
 # Check for injection vulnerabilities
-/security injection <code>
+pa:security injection <code>
 ```
 
 ---

package/proagents/prompts/security-audit/code-review.md

@@ -244,17 +244,17 @@ app.post('/api/users', async (req, res) => {
 
 ```bash
 # Full security audit
-/security audit ./src
+pa:security audit ./src
 
 # Check for OWASP Top 10
-/security owasp ./src/api
+pa:security owasp ./src/api
 
 # Find secrets
-/security secrets ./
+pa:security secrets ./
 
 # Check dependencies
-/security deps
+pa:security deps
 
 # Generate security report
-/security report
+pa:security report
 ```

package/proagents/reverse-engineering/README.md

@@ -21,7 +21,7 @@ Reverse engineering enables ProAgents to:
 
 ### 1. Onboarding to Existing Project
 ```
-/reverse-engineer --full
+pa:reverse-engineer --full
 
 Output:
 - Complete architecture documentation
@@ -33,7 +33,7 @@ Output:
 
 ### 2. Documentation Generation
 ```
-/reverse-engineer --docs
+pa:reverse-engineer --docs
 
 Output:
 - README for each module
@@ -44,7 +44,7 @@ Output:
 
 ### 3. Architecture Understanding
 ```
-/reverse-engineer --architecture
+pa:reverse-engineer --architecture
 
 Output:
 - High-level architecture diagram
@@ -55,7 +55,7 @@ Output:
 
 ### 4. Code Quality Assessment
 ```
-/reverse-engineer --quality
+pa:reverse-engineer --quality
 
 Output:
 - Tech debt identification
@@ -104,21 +104,21 @@ Output:
 
 ```bash
 # Full reverse engineering
-/reverse-engineer
+pa:reverse-engineer
 
 # Specific scope
-/reverse-engineer --scope architecture
-/reverse-engineer --scope api
-/reverse-engineer --scope components
-/reverse-engineer --scope database
+pa:reverse-engineer --scope architecture
+pa:reverse-engineer --scope api
+pa:reverse-engineer --scope components
+pa:reverse-engineer --scope database
 
 # Output format
-/reverse-engineer --format markdown
-/reverse-engineer --format html
-/reverse-engineer --format json
+pa:reverse-engineer --format markdown
+pa:reverse-engineer --format html
+pa:reverse-engineer --format json
 
 # Specific path
-/reverse-engineer --path ./src/modules/auth
+pa:reverse-engineer --path ./src/modules/auth
 ```
 
 ---
@@ -138,14 +138,14 @@ Output:
 
 ---
 
-## Slash Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/reverse-engineer` | Full reverse engineering |
-| `/re-architecture` | Extract architecture only |
-| `/re-docs` | Generate documentation |
-| `/re-diagrams` | Generate diagrams |
-| `/re-patterns` | Detect patterns |
-| `/re-deps` | Map dependencies |
-| `/re-quality` | Quality assessment |
+| `pa:reverse-engineer` | Full reverse engineering |
+| `pa:re-architecture` | Extract architecture only |
+| `pa:re-docs` | Generate documentation |
+| `pa:re-diagrams` | Generate diagrams |
+| `pa:re-patterns` | Detect patterns |
+| `pa:re-deps` | Map dependencies |
+| `pa:re-quality` | Quality assessment |