proagents 1.6.15 → 1.6.17

package/.proagents/examples/README.md

@@ -42,8 +42,8 @@ These show the actual back-and-forth interaction between user and AI.
 # View example for your project type
 proagents example show react
 
-# Initialize with example config
-proagents init --template react
+# Initialize ProAgents
+npx proagents init
 ```
 
 ## Contributing Examples

package/README.md

@@ -9,34 +9,29 @@ A portable, universal development workflow framework that works with **any AI pl
 
 ---
 
-## Installation
+### 📚 [COMMANDS.md](COMMANDS.md) - Complete Command Reference (100+ Commands)
 
-No install required. Just run:
+CLI commands, AI commands (pa:), workflow phases, debugging, testing, deployment, and more.
 
-```bash
-npx proagents init
-```
+---
 
-Or with a template:
+## Why ProAgents?
 
-```bash
-npx proagents init --template nextjs-saas
-```
+- **AI-Agnostic**: Works with Claude, ChatGPT, Gemini, Cursor, Copilot - switch AI tools anytime without losing context
+- **Multi-AI Collaboration**: Multiple AIs can work on the same project with shared context and conflict detection
+- **Guided Workflow**: 10-phase development process from Analysis to Deployment with quality gates
+- **Learning System**: AI learns from your corrections and never repeats the same mistakes
 
-### Upgrading from v1.5.x
+---
 
-Version 1.6.0 renamed `proagents/` to `.proagents/` (following `.github`, `.vscode` convention).
+## Installation
+
+No install required. Just run:
 
 ```bash
-cd your-project
-npx proagents migrate
+npx proagents init
 ```
 
-**What migration does:**
-- Renames `proagents/` → `.proagents/`
-- Updates paths in `README.md`, `CLAUDE.md`, `.cursorrules`
-- Preserves all your existing configurations
-
 ---
 
 ## Quick Start
@@ -48,26 +43,37 @@ cd your-project
 npx proagents init
 ```
 
-This creates a `./.proagents/` folder with workflow files, and prompts for:
-- Project name and type (auto-detected)
-- Tech stack (API style, database, styling, auth, etc.)
-- AI platforms to use (Claude, Cursor, Gemini, etc.)
+**What happens:**
+- Creates `./.proagents/` folder with workflow files
+- Prompts for project name and type (auto-detected)
+- Prompts for tech stack (API style, database, styling, auth)
+- Creates AI instruction files (CLAUDE.md, .cursorrules, etc.)
 
 ### 2. Use Commands in Any AI
 
-Type `pa:` commands in your AI assistant:
+Open your AI assistant (Claude, ChatGPT, Cursor, etc.) and type:
 
 ```
 pa:feature "Add user authentication"
-pa:fix "Login button not working"
-pa:status
 ```
 
-### 3. AI Follows the Guided Workflow
+**What happens:**
+- AI loads project context automatically
+- Guides you through 10-phase workflow
+- Logs all changes for other AIs to see
+
+### 3. See Progress
+
+```
+pa:status
+```
 
+**Example output:**
 ```
-Init → Analysis → Requirements → Design → Planning →
-Implementation → Testing → Review → Documentation → Deployment
+Feature: Add user authentication
+Phase: Implementation (5/10)
+Progress: ████████░░░░ 50%
+Next: pa:test
 ```
 
 ---
@@ -106,22 +112,6 @@ pa:fix "bug in auth"      # AI auto-loads context, then fixes
 pa:undo-last              # Revert last AI's entire session
 ```
 
-### Project Templates
-
-Pre-configured settings for common stacks:
-
-```bash
-npx proagents init --template nextjs-saas      # Next.js SaaS
-npx proagents init --template react-spa        # React SPA
-npx proagents init --template react-native-app # React Native
-npx proagents init --template express-api      # Express API
-npx proagents init --template nestjs-api       # NestJS API
-npx proagents init --template vue-spa          # Vue.js SPA
-npx proagents init --template python-fastapi   # Python FastAPI
-
-npx proagents init --list-templates            # Show all templates
-```
-
 ### AI Learning & Feedback
 
 - **Feedback Log** - AI learns from corrections, doesn't repeat mistakes
@@ -155,514 +145,54 @@ ProAgents follows **"ALWAYS DO, NEVER JUST TELL"** principle:
 ## CLI Commands
 
 ```bash
-# Initialization
-npx proagents init                    # Initialize in project
-npx proagents init --template <name>  # Use a project template
-npx proagents init --list-templates   # List available templates
-
-# Features & Fixes
-proagents feature start "name"        # Start a new feature
-proagents feature status              # Check feature status
-proagents fix "bug description"       # Quick bug fix mode
+# Initialize
+npx proagents init                    # Initialize or update ProAgents
 
-# Maintenance
-proagents doctor                      # Health check installation
-proagents doctor --full               # Extended checks (branches, logs, features)
+# Daily Use
 proagents status                      # Show ProAgents status
-proagents version                     # Show detailed version info
-
-# Release Notes
-proagents release                     # Interactive release note generator
-proagents release -t detailed         # Full comprehensive notes
-proagents release -t short            # Quick summary
-proagents release -t client           # Business-focused, non-technical
-proagents release -t developer        # Technical details for devs
-proagents release -t hotfix           # Urgent patch notes
-proagents release -t prerelease       # Beta/RC notes
-proagents release --include fixes     # Only include bug fixes
-proagents release --include features  # Only include features
-proagents release --append -o FILE    # Append to existing notes
-proagents release --bump              # Suggest version bump
-proagents release --module auth       # Filter by module name
-proagents release --changelog         # Update CHANGELOG.md
-proagents release --tag               # Create git tag
-proagents release --json              # JSON output for CI/CD
-
-# Updating ProAgents
-npx proagents init                    # Smart update (recommended)
-proagents upgrade                     # Full replace (use with caution)
+proagents doctor                      # Health check installation
+proagents stats                       # Show project & AI usage stats
 
 # AI Platforms
 proagents ai list                     # List installed AI platforms
 proagents ai add                      # Add more platforms
-proagents ai remove                   # Remove platforms
 
-# Configuration
-proagents config show                 # Show current config
-proagents config setup                # Interactive config wizard
-proagents config export               # Export config for sharing
-proagents config import <file>        # Import config from file
-
-# Statistics & Monitoring
-proagents stats                       # Show project & AI usage stats
-proagents stats --json                # JSON output for scripting
-
-# Changelog Management
-proagents changelog view              # View recent changelog entries
-proagents changelog add "entry"       # Add new changelog entry
-proagents changelog list              # List available changelogs
-proagents changelog export            # Export to CHANGELOG.md
-proagents changelog git               # View git history as changelog
-
-# Backup & Restore
-proagents restore <backup.json>       # Restore from uninstall backup
-
-# Shell Completions
-proagents completion bash             # Generate bash completions
-proagents completion zsh              # Generate zsh completions
-proagents completion fish             # Generate fish completions
-
-# Quick File Access
-proagents open                        # Show available shortcuts
-proagents open config                 # Open proagents.config.yaml
-proagents open changelog              # Open recent changelog
-proagents open activity               # Open activity log
-proagents open context                # Open worklog context
-
-# Other
-proagents docs                        # Open documentation
-proagents commands                    # Show all commands
-proagents uninstall                   # Remove ProAgents
+# Release
+proagents release                     # Generate release notes
+proagents release --changelog         # Update CHANGELOG.md
 ```
 
-### Updating ProAgents
-
-| Command | What It Does | When to Use |
-|---------|--------------|-------------|
-| `npx proagents init` | **Smart update** - Updates 60 framework folders, merges config, preserves your work | **Recommended** for regular updates |
-| `proagents upgrade` | **Full replace** - Removes everything, installs fresh, restores backups | Only when you need a complete reset |
-
-**What's preserved with `init` (smart update):**
-- `active-features/` - Your work in progress
-- `changelog/` - Your change history (_recent.md, modules/, features/)
-- `worklog/` - Your work context (_context.md, ai-stats.json)
-- `.learning/` - Learned patterns
-- `cache/` - Analysis cache
-- `proagents.config.yaml` - Your values kept, new options merged
-
-**What's preserved with `upgrade` (full replace):**
-- `proagents.config.yaml`, `activity.log`, `handoff.md`, `.lock`
-- `active-features/` - All files
-- `changelog/` - _recent.md, modules/, features/, yearly folders
-- `worklog/` - _context.md, ai-stats.json
+📖 **Want more?** See [COMMANDS.md](COMMANDS.md) for 30+ CLI commands (release notes, stats, config, backups, shell completions...)
 
 ---
 
-## AI Commands (pa:)
+## Essential AI Commands (pa:)
 
 Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.):
 
-### Quick Aliases
-| Alias | Expands To |
-|-------|------------|
-| `pa:f` | `pa:feature` |
-| `pa:s` | `pa:status` |
-| `pa:h` | `pa:help` |
-| `pa:d` | `pa:doc` |
-| `pa:t` | `pa:test` |
-| `pa:q` | `pa:qa` |
-| `pa:a` | `pa:analyze` |
-| `pa:r` | `pa:requirements` |
-| `pa:p` | `pa:plan` |
-| `pa:i` | `pa:implement` |
-| `pa:rev` | `pa:review` |
-| `pa:dbg` | `pa:debug` |
-| `pa:l` | `pa:logs` |
-
-### Core Commands
 | Command | Description |
 |---------|-------------|
 | `pa:feature "name"` | Start new feature workflow (all phases) |
 | `pa:fix "description"` | Quick bug fix mode |
 | `pa:status` | Show current progress |
+| `pa:sync` | Load project context (usually auto) |
+| `pa:test` | Run tests |
+| `pa:review` | Code review workflow |
+| `pa:deploy` | Deployment preparation |
 | `pa:help` | Show all commands |
+| `pa:undo-last` | Revert last AI's changes |
+| `pa:handoff` | Create notes for another AI |
 
-### Workflow Phase Commands
-| Command | Phase | Description |
-|---------|-------|-------------|
-| `pa:analyze` | Analysis | Deep codebase analysis |
-| `pa:requirements` | Requirements | Gather feature requirements |
-| `pa:design` | Design | UI/Architecture design |
-| `pa:plan` | Planning | Create implementation plan |
-| `pa:implement` | Implementation | Execute code changes |
-| `pa:test` | Testing | Create and run tests |
-| `pa:review` | Review | Code review workflow |
-| `pa:doc` | Documentation | Generate documentation |
-| `pa:deploy` | Deployment | Deployment preparation |
-
-### Documentation
-| Command | Description |
-|---------|-------------|
-| `pa:doc` | Generate documentation |
-| `pa:changelog` | Update CHANGELOG.md |
-| `pa:release` | Generate release notes |
-
-### Quality & Testing
-| Command | Description |
-|---------|-------------|
-| `pa:qa` | Run quality assurance checks |
-| `pa:rollback` | Rollback procedures |
-
-### Cross-AI Continuity
-| Command | Description |
-|---------|-------------|
-| `pa:sync` | **Run first** - Load project context |
-| `pa:resume` | Quick resume - shows last session + next action |
-| `pa:session-start` | Begin new work session |
-| `pa:session-end` | Finalize session, update logs |
-| `pa:conflict-check` | Check if files modified by other AI |
-| `pa:undo-last` | Undo last AI's entire session (revert all changes) |
-| `pa:undo-file "path"` | Undo changes to specific file |
-| `pa:changelog` | Update all changelogs |
-| `pa:changelog --from-git` | Auto-populate from git commits |
-| `pa:changelog-feature X` | View feature changelog |
-| `pa:changelog-module X` | View module changelog |
-| `pa:history` | View command history |
-| `pa:activity` | Show recent AI activity |
-| `pa:handoff` | Create handoff notes |
-
-### Learning & Tracking
-| Command | Description |
-|---------|-------------|
-| `pa:decision "title"` | Log architectural decision |
-| `pa:decisions` | Show all decisions |
-| `pa:error "description"` | Log error and solution |
-| `pa:errors` | Search past errors |
-| `pa:feedback "description"` | Log feedback for AI learning |
-
-### AI Platform Management
-| Command | Description |
-|---------|-------------|
-| `pa:ai-list` | List installed AI platforms |
-| `pa:ai-add` | Add more AI platforms |
-| `pa:ai-sync` | Sync config with files |
-
-### Navigation & Flow
-| Command | Description |
-|---------|-------------|
-| `pa:next` | Show next step in workflow |
-| `pa:resume` | Resume paused feature |
-| `pa:skip` | Skip current phase |
-| `pa:back` | Go to previous phase |
-| `pa:progress` | Show visual progress bar |
-
-### Context & History
-| Command | Description |
-|---------|-------------|
-| `pa:context` | View project context |
-| `pa:diff` | Show changes since last session |
-| `pa:history` | Show command history |
-| `pa:checkpoint` | Create restore point |
-| `pa:undo` | Undo last action |
+**Quick aliases:** `pa:f` (feature), `pa:s` (status), `pa:t` (test), `pa:h` (help)
 
-### Sprint & Estimation
-| Command | Description |
-|---------|-------------|
-| `pa:sprint-start` | Start new sprint |
-| `pa:sprint-end` | End sprint with summary |
-| `pa:estimate` | Estimate task complexity |
-| `pa:velocity` | Show velocity metrics |
-
-### Integration
-| Command | Description |
-|---------|-------------|
-| `pa:github` | GitHub integration |
-| `pa:github-pr` | Create pull request |
-| `pa:jira` | Sync with Jira |
-| `pa:notify` | Send notification |
-
-### Code Quality
-| Command | Description |
-|---------|-------------|
-| `pa:metrics` | Code quality metrics |
-| `pa:coverage` | Test coverage report |
-| `pa:deps` | Analyze dependencies |
-| `pa:deps-outdated` | Find outdated packages |
-| `pa:deps-security` | Security scan |
-
-### Code Generation
-| Command | Description |
-|---------|-------------|
-| `pa:generate` | Show generation options |
-| `pa:generate-component` | Generate component |
-| `pa:generate-api` | Generate API endpoint |
-| `pa:generate-test` | Generate test file |
-
-### Refactoring
-| Command | Description |
-|---------|-------------|
-| `pa:refactor` | Suggest refactoring |
-| `pa:rename` | Rename across codebase |
-| `pa:extract` | Extract function/component |
-| `pa:cleanup` | Remove dead code |
-
-### Time Tracking
-| Command | Description |
-|---------|-------------|
-| `pa:time-start` | Start time tracking |
-| `pa:time-stop` | Stop tracking |
-| `pa:time-report` | Show time report |
-
-### Environment & Database
-| Command | Description |
-|---------|-------------|
-| `pa:env-check` | Verify environment |
-| `pa:secrets-scan` | Scan for secrets |
-| `pa:db-migrate` | Run migrations |
-| `pa:db-seed` | Seed database |
-
-### Accessibility & Performance
-| Command | Description |
-|---------|-------------|
-| `pa:a11y` | Accessibility audit |
-| `pa:lighthouse` | Lighthouse audit |
-| `pa:perf` | Performance analysis |
-
-### Export & Learning
-| Command | Description |
-|---------|-------------|
-| `pa:export` | Export config/data |
-| `pa:import` | Import data |
-| `pa:backup` | Backup proagents |
-| `pa:learn` | Teach AI a pattern |
-| `pa:suggestions` | Show AI suggestions |
-
-### API & Documentation
-| Command | Description |
-|---------|-------------|
-| `pa:api-docs` | Generate OpenAPI/Swagger docs |
-| `pa:storybook` | Generate Storybook stories |
-| `pa:readme` | Auto-generate/update README |
-| `pa:types` | Generate TypeScript types |
-
-### Git Advanced
-| Command | Description |
-|---------|-------------|
-| `pa:branch` | Branch management |
-| `pa:merge` | Smart merge with conflict preview |
-| `pa:conflict` | Resolve merge conflicts with AI |
-| `pa:changelog-gen` | Auto-generate changelog |
-
-### Search & Code Navigation
-| Command | Description |
-|---------|-------------|
-| `pa:find` | Find code patterns/usage |
-| `pa:todo` | Find all TODOs in code |
-| `pa:fixme` | Find FIXMEs and critical issues |
-| `pa:unused` | Find unused code/exports |
-
-### Code Analysis
-| Command | Description |
-|---------|-------------|
-| `pa:complexity` | Cyclomatic complexity analysis |
-| `pa:duplication` | Find duplicate code blocks |
-| `pa:hotspots` | Find frequently changed files |
-
-### Debug & Logs
-| Command | Description |
-|---------|-------------|
-| `pa:debug` | Start debug session |
-| `pa:debug-add` | Add debug logs to code |
-| `pa:debug-add "file"` | Add logs to specific file |
-| `pa:debug-trace "func"` | Add entry/exit logs to function |
-| `pa:debug-var "var"` | Track variable changes |
-| `pa:debug-api` | Add API request/response logging |
-| `pa:debug-state` | Add state change logging |
-| `pa:debug-error` | Add error boundary logging |
-| `pa:debug-web` | Web console debugging |
-| `pa:debug-rn` | React Native debugging |
-| `pa:debug-android` | Android native (logcat) |
-| `pa:debug-ios` | iOS native debugging |
-| `pa:logs` | View recent logs |
-| `pa:logs-filter "term"` | Filter logs by term |
-| `pa:debug-clean` | Remove all debug statements |
-
-### Testing Advanced
-| Command | Description |
-|---------|-------------|
-| `pa:test-e2e` | Create/run E2E tests |
-| `pa:test-unit` | Generate unit tests |
-| `pa:mock` | Generate mocks/stubs |
-| `pa:snapshot` | Snapshot testing management |
-
-### DevOps & Infrastructure
-| Command | Description |
-|---------|-------------|
-| `pa:docker` | Docker commands |
-| `pa:ci` | CI/CD pipeline management |
-| `pa:deploy-preview` | Deploy preview environment |
-
-### Release Management
-| Command | Description |
-|---------|-------------|
-| `pa:version` | Show/bump version |
-| `pa:tag` | Create git tag |
-| `pa:publish` | Publish package to registry |
-
-### Code Review & PR
-| Command | Description |
-|---------|-------------|
-| `pa:review-request` | Request code review from team |
-| `pa:review-comments` | Show PR review comments |
-| `pa:review-approve` | Approve current PR |
-
-### Architecture
-| Command | Description |
-|---------|-------------|
-| `pa:architecture` | Show architecture overview |
-| `pa:architecture-diagram` | Generate diagram (Mermaid) |
-| `pa:architecture-export` | Export diagram (SVG/PNG) |
-
-### API Testing
-| Command | Description |
-|---------|-------------|
-| `pa:api-test` | Test API endpoints |
-| `pa:curl` | Generate curl commands |
-| `pa:postman` | Generate Postman collection |
-
-### Health & Monitoring
-| Command | Description |
-|---------|-------------|
-| `pa:health` | Project health check |
-| `pa:monitor` | Show monitoring status |
-| `pa:uptime` | Service uptime check |
-
-### Quick Actions
-| Command | Description |
-|---------|-------------|
-| `pa:quick` | Show quick actions menu |
-| `pa:alias` | Manage command aliases |
-| `pa:alias-add` | Add custom alias |
-| `pa:alias-remove` | Remove custom alias |
-
-### Platform-Specific Test Suites
-
-**Fully automated**: Auto-install tools, run tests, auto-fix failures, loop until all pass.
-
-| Command | Description |
-|---------|-------------|
-| `pa:test-mobile` | Full mobile test suite (React Native, Android, iOS, Flutter) |
-| `pa:test-web` | Full web test suite (React/Next.js/Vue) |
-| `pa:test-api` | Full API test suite (Node.js/Python) |
-| `pa:test-visual` | Visual/design comparison testing |
-| `pa:test-auto-fix` | Auto-fix failing tests |
-| `pa:test-loop` | Test → Fix → Retest until all pass |
-| `pa:compare-figma` | Compare UI against Figma design |
-| `pa:compare-image` | Compare UI against image/sketch |
-| `pa:screenshot` | Capture app screenshots |
-
-**What these commands do:**
-- Check required tools → Auto-install if missing
-- Run all tests (unit, integration, e2e)
-- Auto-fix failures (no confirmation needed)
-- Loop until all pass or fix is impossible
-
-### Custom Commands
-| Command | Description |
-|---------|-------------|
-| `pa:standup` | Generate daily standup |
-| `pa:tech-debt` | Scan for technical debt |
-| `pa:security-scan` | Run security checklist |
-
-Define your own in `./.proagents/custom-commands.yaml`
-
----
-
-## Key Files
-
-After initialization, these files help AI understand your project:
-
-| File | Purpose | AI Should |
-|------|---------|-----------|
-| `.proagents/context.md` | Persistent project knowledge | **Read first every session!** |
-| `.proagents/feedback.md` | Past corrections & preferences | Learn from mistakes |
-| `.proagents/watchlist.yaml` | Protected files list | Ask before modifying |
-| `.proagents/activity.log` | AI activity history | Check for conflicts |
-| `.proagents/decisions.md` | Architectural decisions | Understand why choices were made |
-| `.proagents/errors.md` | Past errors & solutions | Find solutions faster |
-| `.proagents/handoff.md` | Handoff notes | Continue where another AI left off |
-
----
-
-## Project Structure
-
-```
-your-project/
-├── .proagents/
-│   ├── proagents.config.yaml   # Project configuration
-│   ├── AI_INSTRUCTIONS.md      # Instructions for all AIs
-│   ├── PROAGENTS.md            # Quick command reference
-│   ├── context.md              # Persistent project context
-│   ├── feedback.md             # AI learning from corrections
-│   ├── watchlist.yaml          # Protected files
-│   ├── activity.log            # AI activity log
-│   ├── decisions.md            # Decision log
-│   ├── errors.md               # Error tracker
-│   ├── handoff.md              # Handoff notes
-│   ├── custom-commands.yaml    # Custom pa: commands
-│   ├── worklog/                # Cross-AI session tracking
-│   │   ├── _context.md         # Quick context for any AI
-│   │   ├── ai-stats.json       # AI performance stats
-│   │   └── YYYY-MM-DD-ai-*.md  # Session logs
-│   ├── changelog/              # Detailed changelogs
-│   │   ├── _recent.md          # Last 10 changes
-│   │   ├── features/           # Per-feature changelogs
-│   │   └── modules/            # Per-module changelogs
-│   ├── active-features/        # Feature tracking
-│   ├── prompts/                # Workflow prompts
-│   ├── templates/              # Document templates
-│   ├── checklists/             # Quality checklists
-│   └── ...
-├── CLAUDE.md                   # Claude-specific instructions
-├── .cursorrules                # Cursor-specific instructions
-├── GEMINI.md                   # Gemini-specific instructions
-└── proagents.config.yaml       # Main config (project root)
-```
-
----
-
-## Configuration
-
-`proagents.config.yaml` stores your project settings:
-
-```yaml
-project:
-  name: my-app
-  type: nextjs
-
-automation:
-  decisions:
-    architecture:
-      api_style: rest
-      state_management: zustand
-      styling: tailwind
-      database: postgresql
-      orm: prisma
-      auth_method: jwt
-    testing:
-      framework: vitest
-      coverage_target: 80
-
-platforms:
-  - claude
-  - cursor
-  - copilot
-```
+📖 **Want more?** See [COMMANDS.md](COMMANDS.md) for 100+ AI commands (debugging, testing, refactoring, code generation, sprints...)
 
 ---
 
 ## Supported AI Platforms
 
+ProAgents works with **any AI that has agentic capability** (can read files and execute commands). Pre-configured instruction files are available for:
+
 | Platform | Instruction File |
 |----------|-----------------|
 | Claude Code | `CLAUDE.md` |
@@ -677,17 +207,7 @@ platforms:
 | Kiro | `KIRO.md` |
 | Groq | `GROQ.md` |
 
----
-
-## 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
+**Using a different AI?** Point it to `.proagents/AI_INSTRUCTIONS.md` - it contains everything needed to work with ProAgents.
 
 ---
 
@@ -695,6 +215,7 @@ platforms:
 
 | Document | Description |
 |----------|-------------|
+| 📚 **[COMMANDS.md](COMMANDS.md)** | **100+ CLI & AI commands** |
 | [Getting Started Story](./.proagents/GETTING-STARTED-STORY.md) | Narrative walkthrough |
 | [Complete Workflow](./.proagents/WORKFLOW.md) | 10-phase workflow guide |
 | [AI Instructions](./.proagents/AI_INSTRUCTIONS.md) | Full AI command reference |

package/bin/proagents.js

@@ -12,7 +12,7 @@ import { configListCommand, configShowCommand, configEditCommand, configSetComma
 import { doctorCommand } from '../lib/commands/doctor.js';
 import { upgradeCommand } from '../lib/commands/upgrade.js';
 import { migrateCommand } from '../lib/commands/migrate.js';
-import { versionCommand } from '../lib/commands/version.js';
+import { versionCommand, checkForUpdates } from '../lib/commands/version.js';
 import { releaseCommand } from '../lib/commands/release.js';
 import { statsCommand } from '../lib/commands/stats.js';
 import { restoreCommand } from '../lib/commands/restore.js';
@@ -42,8 +42,6 @@ program
   .description('Initialize ProAgents in the current project')
   .option('-f, --force', 'Overwrite existing proagents folder')
   .option('--skip-config', 'Skip creating config file')
-  .option('-t, --template <name>', 'Use a project template (e.g., nextjs-saas, react-spa)')
-  .option('--list-templates', 'List available project templates')
   .action(initCommand);
 
 // Feature commands
@@ -314,3 +312,11 @@ program
   .action(openCommand);
 
 program.parse();
+
+// Check for updates after command completes (non-blocking)
+// Skip for version command (it already shows version info)
+const commandName = program.args[0];
+if (commandName !== 'version' && commandName !== '--version' && commandName !== '-V') {
+  // Run update check in background without blocking
+  checkForUpdates().catch(() => {});
+}

package/lib/commands/init.js

@@ -316,115 +316,6 @@ const PROJECT_TYPES = [
   }
 ];
 
-// Project templates - pre-configured settings for common stacks
-const PROJECT_TEMPLATES = {
-  'nextjs-saas': {
-    name: 'Next.js SaaS Starter',
-    description: 'Full-stack SaaS with authentication, database, and payments',
-    project: { type: 'nextjs' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'zustand',
-      styling: 'tailwind',
-      database: 'postgresql',
-      orm: 'prisma',
-      auth_method: 'nextauth',
-      test_framework: 'vitest'
-    },
-    platforms: ['claude', 'cursor', 'copilot']
-  },
-  'react-spa': {
-    name: 'React Single Page App',
-    description: 'Frontend-focused React application with modern tooling',
-    project: { type: 'react' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'zustand',
-      styling: 'tailwind',
-      database: 'none',
-      orm: 'none',
-      auth_method: 'jwt',
-      test_framework: 'vitest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'react-native-app': {
-    name: 'React Native Mobile App',
-    description: 'Cross-platform mobile app with Expo',
-    project: { type: 'react-native' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'zustand',
-      styling: 'tailwind',
-      database: 'supabase',
-      orm: 'none',
-      auth_method: 'supabase',
-      test_framework: 'jest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'express-api': {
-    name: 'Express.js REST API',
-    description: 'Backend API with Express, PostgreSQL, and JWT auth',
-    project: { type: 'express' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'none',
-      styling: 'none',
-      database: 'postgresql',
-      orm: 'prisma',
-      auth_method: 'jwt',
-      test_framework: 'jest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'nestjs-api': {
-    name: 'NestJS Enterprise API',
-    description: 'Enterprise-grade API with NestJS and TypeORM',
-    project: { type: 'nestjs' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'none',
-      styling: 'none',
-      database: 'postgresql',
-      orm: 'typeorm',
-      auth_method: 'jwt',
-      test_framework: 'jest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'vue-spa': {
-    name: 'Vue.js Single Page App',
-    description: 'Vue 3 with Composition API and Pinia',
-    project: { type: 'vue' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'none',
-      styling: 'tailwind',
-      database: 'none',
-      orm: 'none',
-      auth_method: 'jwt',
-      test_framework: 'vitest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'python-fastapi': {
-    name: 'Python FastAPI',
-    description: 'Modern Python API with FastAPI and SQLAlchemy',
-    project: { type: 'python' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'none',
-      styling: 'none',
-      database: 'postgresql',
-      orm: 'none',
-      auth_method: 'jwt',
-      test_framework: 'pytest'
-    },
-    platforms: ['claude', 'cursor']
-  }
-};
-
 // Tech stack configuration options
 const TECH_STACK_OPTIONS = {
   api_style: {
@@ -963,41 +854,6 @@ async function promptProjectConfig(targetDir, existingConfig = {}) {
   };
 }
 
-/**
- * List available templates
- */
-export function listTemplates() {
-  console.log(chalk.bold('\nAvailable Project Templates'));
-  console.log(chalk.gray('─'.repeat(50)));
-
-  for (const [id, template] of Object.entries(PROJECT_TEMPLATES)) {
-    console.log(`\n  ${chalk.cyan(id)}`);
-    console.log(`    ${template.name}`);
-    console.log(chalk.gray(`    ${template.description}`));
-  }
-
-  console.log(chalk.gray('\n\nUsage: npx proagents init --template <name>\n'));
-}
-
-/**
- * Apply a project template
- */
-function applyTemplate(templateId, targetDir) {
-  const template = PROJECT_TEMPLATES[templateId];
-  if (!template) {
-    return null;
-  }
-
-  // Return config object that matches what promptProjectConfig returns
-  return {
-    name: basename(targetDir),
-    type: template.project.type,
-    typeName: PROJECT_TYPES.find(t => t.id === template.project.type)?.name || template.project.type,
-    techStack: template.techStack,
-    platforms: template.platforms
-  };
-}
-
 /**
  * Load existing partial config (for resume after interrupted setup)
  */
@@ -1331,27 +1187,8 @@ No releases yet. Use \`pa:release\` to generate release notes.
       console.log(chalk.green('✓ Created RELEASE_NOTES.md'));
     }
 
-    // Project configuration - either from template or interactive prompt
-    let projectConfig;
-
-    if (options.listTemplates) {
-      listTemplates();
-      return;
-    }
-
-    if (options.template) {
-      // Use template
-      projectConfig = applyTemplate(options.template, targetDir);
-      if (!projectConfig) {
-        console.log(chalk.red(`\nError: Template "${options.template}" not found.`));
-        listTemplates();
-        return;
-      }
-      console.log(chalk.green(`\n✓ Using template: ${PROJECT_TEMPLATES[options.template].name}`));
-    } else {
-      // Interactive prompts - pass existing config for pre-filling
-      projectConfig = await promptProjectConfig(targetDir, existingConfig);
-    }
+    // Project configuration - interactive prompts with auto-detection
+    const projectConfig = await promptProjectConfig(targetDir, existingConfig);
 
     // Save progress after project config
     savePartialConfig(configPath, {
@@ -1394,15 +1231,8 @@ For detailed commands, see \`./.proagents/PROAGENTS.md\`
       console.log(chalk.green('✓ Created README.md with ProAgents commands'));
     }
 
-    // AI platform selection - from template or interactive
-    let selectedPlatforms;
-    if (options.template && projectConfig.platforms) {
-      selectedPlatforms = projectConfig.platforms;
-      console.log(chalk.gray(`  Using template platforms: ${selectedPlatforms.join(', ')}`));
-    } else {
-      // Pass existing config for pre-selection
-      selectedPlatforms = await selectPlatforms(existingConfig.ai_platforms);
-    }
+    // AI platform selection - interactive with auto-detection
+    const selectedPlatforms = await selectPlatforms(existingConfig.ai_platforms);
 
     // Save progress after platform selection
     savePartialConfig(configPath, {

package/lib/commands/version.js

@@ -9,7 +9,7 @@ const __dirname = dirname(__filename);
 /**
  * Get CLI version from package.json
  */
-function getCliVersion() {
+export function getCliVersion() {
   try {
     const packagePath = join(__dirname, '..', '..', 'package.json');
     const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
@@ -41,7 +41,7 @@ function getProjectVersion(targetDir) {
 /**
  * Fetch latest version from npm
  */
-async function getLatestVersion() {
+export async function getLatestVersion() {
   try {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 5000);
@@ -66,7 +66,7 @@ async function getLatestVersion() {
  * Compare semantic versions
  * Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
  */
-function compareVersions(v1, v2) {
+export function compareVersions(v1, v2) {
   const parts1 = v1.split('.').map(Number);
   const parts2 = v2.split('.').map(Number);
 
@@ -79,6 +79,27 @@ function compareVersions(v1, v2) {
   return 0;
 }
 
+/**
+ * Check for updates and display notification if available
+ * Non-blocking - runs asynchronously
+ */
+export async function checkForUpdates() {
+  try {
+    const cliVersion = getCliVersion();
+    const latestVersion = await getLatestVersion();
+
+    if (latestVersion && compareVersions(cliVersion, latestVersion) < 0) {
+      console.log('');
+      console.log(chalk.yellow(`  ╭───────────────────────────────────────────────╮`));
+      console.log(chalk.yellow(`  │  Update available: ${chalk.gray('v' + cliVersion)} → ${chalk.green('v' + latestVersion)}              │`));
+      console.log(chalk.yellow(`  │  Run: ${chalk.cyan('npx proagents init')} to update         │`));
+      console.log(chalk.yellow(`  ╰───────────────────────────────────────────────╯`));
+    }
+  } catch (error) {
+    // Silently ignore update check errors
+  }
+}
+
 /**
  * Version command - show detailed version information
  */
@@ -118,7 +139,7 @@ export async function versionCommand(options = {}) {
         console.log(chalk.green('v' + latestVersion + ' (up to date)'));
       } else {
         console.log(chalk.yellow('v' + latestVersion + ' (update available)'));
-        console.log(chalk.yellow(`                    ↳ Run 'npm update -g proagents' to update`));
+        console.log(chalk.yellow(`                    ↳ Run 'npx proagents init' to update`));
       }
     } else {
       console.log(chalk.gray('Could not fetch (offline or npm unavailable)'));

package/package.json

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