@amrhas82/agentic-kit 1.7.7 → 1.8.1

package/README.md

@@ -1,6 +1,6 @@
 # Agentic Kit
 
-> **AI-powered development toolkit with 14 specialized agents and 20 workflow commands**
+> **AI development toolkit with 14 specialized agents and 20 commands per tool**
 
 [![npm version](https://img.shields.io/npm/v/@amrhas82/agentic-kit)](https://www.npmjs.com/package/@amrhas82/agentic-kit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -11,177 +11,114 @@
 [![Ampcode](https://img.shields.io/badge/Ampcode-Supported-orange)](https://github.com/amrhas82/ampcode)
 [![Droid](https://img.shields.io/badge/Droid-Supported-red)](https://github.com/amrhas82/droid)
 
-Comprehensive toolkit featuring specialized AI agents and workflow commands for product management, agile development, and software engineering. **Interactive multi-tool installer** supports Claude, Opencode, Ampcode, and Droid.
+Specialized AI agents and workflow commands for product management, agile development, and software engineering. Simple installer supports Claude, Opencode, Ampcode, and Droid.
 
 ---
 
 ## 🚀 Quick Start
 
-### Interactive Installer (Recommended)
-
 ```bash
-# Install globally
+# Install
 npm install -g @amrhas82/agentic-kit
 
-# Run interactive installer
-agentic-kit install
-```
-
-The installer guides you through:
-1. **Select Variant** - Lite, Standard, or Pro
-2. **Select Tools** - Claude, Opencode, Ampcode, Droid (or all)
-3. **Configure Paths** - Use defaults or customize
-4. **Install** - Watch real-time progress
+# Run installer
+agentic-kit
 
-**Silent Installation (CI/CD):**
-```bash
-agentic-kit install --silent --variant=standard --tools=claude
+# Choose tool(s): claude, opencode, ampcode, or droid
+# Each tool gets 14 agents + 20 commands
 ```
 
-📖 **[Full Installation Guide →](docs/INSTALLER_GUIDE.md)**
-
-### Variants
-
-| Variant | Agents | Commands/Skills | Size | Best For |
-|---------|--------|-----------------|------|----------|
-| **Lite** | 5 | 20 | ~500 KB | Minimal setup, CI/CD |
-| **Standard** ⭐ | 10 | 20 | ~1 MB | Most users |
-| **Pro** | 14 | 20 | ~1.5 MB | Full features |
-
 ### Supported Tools
 
-- **Claude** - Skills + Commands (separate categories)
-- **Opencode** - Commands (unified)
-- **Ampcode** - Commands (unified)
-- **Droid** - Commands (unified)
+- **Claude Code** - 14 subagents + 11 skills + 9 commands
+- **Opencode** - 14 agent references + 20 commands
+- **Ampcode** - 14 agent references + 20 commands
+- **Droid** - 14 agent references + 20 commands
+
+**Key Difference:**
+- **Claude Code**: Full subagent system with orchestrator + skills (auto-triggering)
+- **Other tools**: Commands only + agent reference documentation
 
 ### Start Using
 
 ```bash
-# Get help
+# Claude Code examples
 @master help
-
-# Create a Product Requirements Document
 @1-create-prd Create a PRD for a task management app
+/brainstorming Explore authentication approaches
+/test-driven-development Implement user login
 
-# Generate development tasks
-@2-generate-tasks Break down this feature into tasks
-
-# Process task list
-@3-process-task-list Execute this task list
+# Opencode/Ampcode/Droid examples
+/1-create-prd Create a PRD for a task management app
+/brainstorming Explore authentication approaches
+/test-driven-development Implement user login
 ```
 
 ---
 
-## 📖 Documentation
-
-| Document | Description |
-|----------|-------------|
-| **[INSTALLER_GUIDE.md](docs/INSTALLER_GUIDE.md)** | Complete installation guide with troubleshooting |
-| **[KNOWLEDGE_BASE.md](docs/KNOWLEDGE_BASE.md)** | Complete reference: all agents, commands, architecture |
-| **[QUICK-START.md](QUICK-START.md)** | 15-minute onboarding guide |
-| **[VARIANTS.md](VARIANTS.md)** | Compare variants and choose the right one |
-| **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** | Common issues and solutions |
-
----
-
 ## 🤖 What's Included
 
-### Agents (14 Total)
+### 14 Agents
 
-**Workflow Agents:**
-- **1-create-prd** - Generate product requirements documents
+**Workflow Agents (3):**
+- **1-create-prd** - Product requirements documents
 - **2-generate-tasks** - Break down features into tasks
 - **3-process-task-list** - Execute task lists systematically
 
-**Core Team:**
-- **master** - General task executor
-- **orchestrator** - Workflow coordination
-- **code-developer** - Implementation and debugging
-- **quality-assurance** - Testing and quality gates
+**Core Team (5):**
+- **master** - General task executor with comprehensive expertise
+- **orchestrator** - Workflow coordination and intent matching
+- **code-developer** - Implementation, debugging, refactoring
+- **quality-assurance** - Test architecture and quality gates
 - **context-builder** - Project initialization and documentation
 
-**Product & Planning:**
-- **feature-planner** - Product strategy and roadmap
-- **backlog-manager** - Backlog management
+**Product & Planning (3):**
+- **feature-planner** - Product strategy, PRDs, roadmaps
+- **backlog-manager** - Backlog management and sprint planning
 - **story-writer** - User stories and agile workflows
-- **market-researcher** - Research and analysis
+- **market-researcher** - Market research and competitive analysis
 
-**Architecture & Design:**
+**Architecture & Design (2):**
 - **system-architect** - System design and architecture
 - **ui-designer** - UI/UX design and wireframes
 
-### Commands & Skills (20 Total)
+### 20 Commands/Skills
+
+**Auto-Triggering Skills (4)** - Claude Code only:
+- **test-driven-development** - Write test first, watch fail, minimal passing code
+- **testing-anti-patterns** - Prevent mocking anti-patterns
+- **verification-before-completion** - Verify before claiming done
+- **subagent-spawning** - TDD-aware templates for fresh subagents
 
-**Core Workflow Skills (Claude: skills/, Others: commands/):**
+**Manual Skills/Commands (16):**
 - **brainstorming** - Structured brainstorming sessions
-- **code-review** - Comprehensive code reviews
-- **condition-based-waiting** - Robust waiting mechanisms for tests
+- **code-review** - Implementation review against requirements
+- **condition-based-waiting** - Replace timeouts with condition polling
 - **docs-builder** - Project documentation generation
-- **root-cause-tracing** - Debug tracing and investigation
-- **skill-creator** - Create new reusable skills
-- **subagent-spawning** - Fresh subagent templates for task isolation
+- **root-cause-tracing** - Trace bugs backward through call stack
+- **skill-creator** - Guide for creating new skills
 - **systematic-debugging** - Four-phase debugging framework
-- **test-driven-development** - TDD workflow enforcement
-- **testing-anti-patterns** - Identify and avoid test anti-patterns
-- **verification-before-completion** - Verify before claiming done
-
-**Development Commands (Claude: commands/, Others: commands/):**
 - **debug** - Systematic issue investigation
-- **explain** - Explain code for new team members
-- **git-commit** - Intelligent git commits
-- **optimize** - Performance analysis and optimization
+- **explain** - Explain code for newcomers
+- **git-commit** - Intelligent commit creation
+- **optimize** - Performance analysis
 - **refactor** - Safe refactoring with behavior preservation
 - **review** - Comprehensive code review
-- **security** - Security vulnerability scanning
-- **ship** - Pre-deployment verification
-- **test-generate** - Generate comprehensive test suites
+- **security** - Vulnerability scanning
+- **ship** - Pre-deployment checklist
+- **test-generate** - Generate test suites
 
 ---
 
-## 🔧 Installation Options
-
-### Option 1: Interactive Installer ⭐ (Recommended)
-
-```bash
-npm install -g @amrhas82/agentic-kit
-agentic-kit install
-```
-
-**Features:**
-- Choose variant (Lite/Standard/Pro)
-- Select tools (Claude, Opencode, Ampcode, Droid)
-- Configure installation paths
-- Real-time progress tracking
-- Automatic verification
-- Rollback on failure
-
-**Advanced Options:**
-```bash
-# Silent installation
-agentic-kit install --silent --variant=standard --tools=claude
-
-# Multiple tools
-agentic-kit install --variant=pro --tools=claude,opencode
-
-# Custom path
-agentic-kit install --tools=claude --path claude=/custom/path
-
-# Uninstall
-agentic-kit install --uninstall --tools=claude
-```
-
-### Option 2: Claude Code via GitHub
-
-```bash
-/plugin add github:amrhas82/agentic-kit
-```
-
-### Option 3: npx (Run Temporarily)
+## 📖 Documentation
 
-```bash
-npx @amrhas82/agentic-kit
-```
+| Document | Description |
+|----------|-------------|
+| **[INSTALLER_GUIDE.md](docs/INSTALLER_GUIDE.md)** | Complete installation guide with troubleshooting |
+| **[KNOWLEDGE_BASE.md](docs/KNOWLEDGE_BASE.md)** | Complete reference: agents, commands, architecture |
+| **[QUICK-START.md](QUICK-START.md)** | 15-minute onboarding guide |
+| **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** | Common issues and solutions |
+| **[subagentic-manual.md](packages/subagentic-manual.md)** | Detailed agent/command reference |
 
 ---
 
@@ -189,12 +126,12 @@ npx @amrhas82/agentic-kit
 
 **Feature Development:**
 ```
-@orchestrator I need to add user authentication to my app
-# Orchestrator analyzes → routes to appropriate agents
+@orchestrator I need to add user authentication
+# Orchestrator routes to:
 # → market-researcher (research approaches)
-# → 1-create-prd (formal requirements)
+# → 1-create-prd (requirements)
 # → 2-generate-tasks (implementation tasks)
-# → 3-process-task-list (systematic execution)
+# → 3-process-task-list (execution)
 ```
 
 **Code Quality:**
@@ -206,57 +143,36 @@ npx @amrhas82/agentic-kit
 
 **Architecture & Design:**
 ```
-@system-architect Design a microservices architecture for this monolith
-@ui-designer Create wireframes for the mobile checkout flow
+@system-architect Design microservices architecture
+@ui-designer Create wireframes for mobile checkout
 ```
 
 ---
 
-## 📦 npm Scripts
-
-### Installation
-```bash
-npm run install-interactive  # Run interactive installer
-npm run uninstall-tool       # Uninstall a tool
-```
+## 🔧 Advanced Usage
 
-### Testing
+### Silent Installation (CI/CD)
 ```bash
-npm test                # Run all tests
-npm run test-installer  # Run installer tests
+agentic-kit --tool claude --yes
 ```
 
-### Validation
+### Multiple Tools
 ```bash
-npm run validate         # Validate package structure
-npm run validate-packages # Validate all tool packages
+agentic-kit
+# Enter: claude opencode
 ```
 
-### Publishing
+### Uninstall
 ```bash
-npm run publish:npm      # Publish to npm
-npm run publish:github   # Publish to GitHub packages
-npm run publish:both     # Publish to both registries
+agentic-kit --uninstall claude
 ```
 
 ---
 
-## 🤝 Contributing
-
-We welcome contributions! See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines.
-
-1. Fork the repo
-2. Create a feature branch
-3. Add your agent or command
-4. Submit a pull request
-
----
-
 ## 📊 Stats
 
 - **14** Specialized Agents
 - **20** Workflow Commands & Skills
-- **3** Variants (Lite/Standard/Pro)
 - **4** Supported Tools (Claude, Opencode, Ampcode, Droid)
 - **MIT** License
 

package/installer/cli.js

@@ -256,8 +256,8 @@ ${colors.bright}For more information, visit:${colors.reset}
       // Interactive mode
       this.showWelcome();
 
-      // Prompt for telemetry consent (first-time only)
-      await this.promptTelemetryConsent();
+      // Hardcode to Pro variant - everyone gets all features
+      this.selections.variant = 'pro';
 
       // Check for interrupted installation
       const InstallationEngine = require('./installation-engine');
@@ -280,10 +280,9 @@ ${colors.bright}For more information, visit:${colors.reset}
         }
       }
 
-      // Normal installation flow
-      await this.selectVariant();
+      // Simplified installation flow
       await this.selectTools();
-      await this.configurePaths();
+      await this.setDefaultPaths();
       await this.showSummary();
       await this.install();
     } catch (error) {
@@ -1060,12 +1059,15 @@ ${colors.bright}For more information, visit:${colors.reset}
     console.clear();
     console.log(`
 ${colors.bright}${colors.cyan}┌─────────────────────────────────────────────────────────────┐${colors.reset}
-${colors.bright}${colors.cyan}│              Agentic Kit Installer v1.1.0                    │${colors.reset}
-${colors.bright}${colors.cyan}│         Multi-Tool AI Development Kit Installer               │${colors.reset}
+${colors.bright}${colors.cyan}│              Agentic Kit Installer v1.2.0                    │${colors.reset}
+${colors.bright}${colors.cyan}│           14 Agents + 20 Commands Per Tool                    │${colors.reset}
 ${colors.bright}${colors.cyan}└─────────────────────────────────────────────────────────────┘${colors.reset}
 
-${colors.bright}This installer will set up AI development tools for:${colors.reset}
-• Claude Code • Opencode • Ampcode • Droid
+${colors.bright}Available tools:${colors.reset}
+• ${colors.cyan}claude${colors.reset}    - Claude Code (AI development assistant)
+• ${colors.cyan}opencode${colors.reset}  - OpenCode (CLI-optimized AI tool)
+• ${colors.cyan}ampcode${colors.reset}   - Ampcode (Development accelerator)
+• ${colors.cyan}droid${colors.reset}     - Droid (Android-focused assistant)
 
 ${colors.yellow}Press Enter to begin or Ctrl+C to exit${colors.reset}
     `);
@@ -1105,29 +1107,18 @@ ${colors.yellow}Press Enter to begin or Ctrl+C to exit${colors.reset}
   }
   
   async selectTools() {
-    console.log(`\n${colors.bright}Step 2/4 — Choose Tools (Minimum 1 required)${colors.reset}\n`);
-
-    console.log(`${colors.cyan}Available Tools:${colors.reset}\n`);
-
-    // Display each tool with detailed information
-    this.tools.forEach((tool, index) => {
-      const num = index + 1;
-      console.log(`${colors.bright}${num}. ${tool.name}${colors.reset}`);
-      console.log(`   ${colors.cyan}Description:${colors.reset} ${tool.description}`);
-      console.log(`   ${colors.cyan}Best for:${colors.reset} ${tool.useCase}`);
-      console.log(`   ${colors.cyan}Target Users:${colors.reset} ${tool.targetUsers}`);
-      console.log(`   ${colors.cyan}Default Path:${colors.reset} ${tool.path}`);
-      console.log('');
+    console.log(`\n${colors.bright}Which tool(s) do you want to install?${colors.reset}\n`);
+
+    // Display tools in a simple list
+    this.tools.forEach((tool) => {
+      console.log(`  ${colors.cyan}${tool.id.padEnd(10)}${colors.reset} - ${tool.description}`);
     });
 
-    console.log(`${colors.yellow}Select tools by entering IDs separated by spaces${colors.reset}`);
-    console.log(`${colors.yellow}Examples:${colors.reset}`);
-    console.log(`  "claude"                 - Install Claude Code only`);
-    console.log(`  "claude opencode"        - Install Claude Code and Opencode`);
-    console.log(`  "claude opencode ampcode droid" - Install all tools`);
+    console.log(`\n${colors.yellow}Enter tool IDs separated by spaces (e.g., "claude opencode")${colors.reset}`);
+    console.log(`${colors.yellow}Default: claude${colors.reset}`);
 
     return new Promise(resolve => {
-      this.rl.question(`\n${colors.bright}Select tools:${colors.reset} `, (answer) => {
+      this.rl.question(`\n${colors.bright}Tools:${colors.reset} `, (answer) => {
         if (answer.trim()) {
           const selected = answer.toLowerCase().split(/\s+/);
           this.selections.tools = selected.filter(id =>
@@ -1143,23 +1134,31 @@ ${colors.yellow}Press Enter to begin or Ctrl+C to exit${colors.reset}
           }
         }
 
+        // Default to claude if nothing selected
         if (this.selections.tools.length === 0) {
-          console.log(`${colors.red}Error: At least one tool must be selected${colors.reset}`);
-          console.log(`${colors.yellow}Valid tool IDs: ${this.tools.map(t => t.id).join(', ')}${colors.reset}\n`);
-          throw new Error('At least one tool must be selected');
+          this.selections.tools = ['claude'];
+          console.log(`${colors.blue}Using default: claude${colors.reset}`);
         }
 
         // Show selection summary
-        console.log(`\n${colors.green}Selected ${this.selections.tools.length}/${this.tools.length} tools:${colors.reset}`);
+        console.log(`\n${colors.green}Installing:${colors.reset}`);
         this.selections.tools.forEach(id => {
           const tool = this.tools.find(t => t.id === id);
-          console.log(`  ${colors.green}✓${colors.reset} ${tool.name}`);
+          console.log(`  ${colors.green}✓${colors.reset} ${tool.name} ${colors.cyan}(14 agents + 20 commands)${colors.reset}`);
         });
 
         resolve();
       });
     });
   }
+
+  async setDefaultPaths() {
+    // Automatically use default paths for all selected tools
+    for (const toolId of this.selections.tools) {
+      const tool = this.tools.find(t => t.id === toolId);
+      this.selections.paths[toolId] = tool.path;
+    }
+  }
   
   async configurePaths() {
     console.log(`\n${colors.bright}Step 3/4 — Path Configuration${colors.reset}\n`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@amrhas82/agentic-kit",
-  "version": "1.7.7",
-  "description": "Comprehensive toolkit for AI-driven software development with 13 specialized agents and 22 powerful skills. Interactive multi-tool installer supports Claude, Opencode, Ampcode, and Droid. Available in 3 variants: Lite (3 agents, 510 KB), Standard (13 agents, 8 skills, 8.4 MB), Pro (13 agents, 22 skills, 9 MB)",
+  "version": "1.8.1",
+  "description": "AI development toolkit with 14 specialized agents and 20 commands. Simple one-question installer for Claude, Opencode, Ampcode, and Droid.",
   "main": "index.js",
   "bin": {
     "agentic-kit": "./installer/cli.js",
@@ -73,7 +73,6 @@
     "postinstall.js",
     "README.md",
     "QUICK-START.md",
-    "VARIANTS.md",
     "TROUBLESHOOTING.md",
     "CHANGELOG.md",
     "LICENSE"

package/postinstall.js

@@ -5,24 +5,21 @@ const message = `
   Agentic Kit Installation Complete
 ==========================================
 
-Next step: Run the interactive installer
+Next step: Run the installer
 
   $ agentic-kit
 
-Available tools:
-  • Claude Code    - Full-featured AI development assistant
-  • OpenCode       - Open-source AI coding tool
-  • Ampcode        - Amplified coding agent
-  • Droid          - Android-focused development assistant
+Each tool includes 14 agents + 20 commands
 
-Each tool offers 3 variants:
-  • Lite     - 3 agents (510 KB)
-  • Standard - 13 agents + 8 skills (8.4 MB)
-  • Pro      - 13 agents + 22 skills (9 MB)
+Available tools:
+  • claude    - Claude Code (AI development assistant)
+  • opencode  - OpenCode (CLI-optimized AI tool)
+  • ampcode   - Ampcode (Development accelerator)
+  • droid     - Droid (Android-focused assistant)
 
 Quick commands:
-  agentic-kit              # Interactive installer
-  agentic-kit --uninstall  # Remove installed tools
+  agentic-kit              # Install tools
+  agentic-kit --uninstall  # Remove tools
 
 Documentation:
   https://github.com/amrhas82/agentic-kit

package/VARIANTS.md

@@ -1,411 +0,0 @@
-# Variant Comparison & Selection Guide
-
-Complete comparison of Agentic Toolkit variants and guidance for choosing the right one for your needs.
-
-## Variant Overview
-
-The Agentic Toolkit comes in three variants, each designed for different user needs and use cases:
-
-- **Lite** - Minimal footprint, essential capabilities, explorers
-- **Standard** - Complete agent suite, core skills, teams (recommended)
-- **Pro** - All agents, all skills, enterprises and power users
-
-## Detailed Comparison
-
-### Agents Availability
-
-#### Lite Variant
-- Master
-- Orchestrator
-- 1 additional core agent (to be determined based on use case)
-
-**Perfect for:** Learning, exploration, basic task execution
-
-#### Standard Variant (Recommended)
-- Master
-- Orchestrator
-- Product Manager
-- Product Owner
-- Business Analyst
-- Full-Stack Developer
-- Holistic Architect
-- UX Expert
-- QA Test Architect
-- Scrum Master
-- Context Initializer 
-- Create PRD
-- Generate Tasks
-- Process Task List
-
-**Perfect for:** Product teams, development teams, organizations needing full toolkit
-
-#### Pro Variant
-- All 14 agents (same as Standard)
-
-**Perfect for:** Enterprise teams with diverse needs
-
-### Skills Availability
-
-#### Lite Variant
-- PDF (basic)
-
-**Total:** 1 skill
-**Focus:** Essential document processing
-
-#### Standard Variant
-Core Document Processing (4):
-- PDF - Comprehensive PDF manipulation
-- DOCX - Word document creation and editing
-- XLSX - Spreadsheet creation and analysis
-- PPTX - Presentation creation
-
-Design & Content (4):
-- Canvas Design - Visual design and artwork
-- Theme Factory - Theme and styling
-- Brand Guidelines - Brand compliance
-- Internal Communications - Internal documents
-
-**Total:** 8 skills
-**Focus:** Complete professional capability set
-
-#### Pro Variant
-All Standard Skills (8) plus Advanced:
-- MCP Builder - Build Model Context Protocol servers
-- Skill Creator - Create custom skills
-- Web App Testing - Comprehensive web testing
-- Slack GIF Creator - Generate animated GIFs
-- Algorithmic Art - Algorithmic art generation
-- Artifacts Builder - Complex HTML artifacts
-
-**Total:** 14 skills
-**Focus:** Maximum extensibility and advanced features
-
-### Size & Performance
-
-| Metric | Lite | Standard | Pro |
-|--------|------|----------|-----|
-| **Download Size** | ~2MB | ~8MB | ~16MB |
-| **Installation Time** | <1 minute | 2-3 minutes | 3-5 minutes |
-| **Memory Footprint** | Minimal | Moderate | Larger |
-| **Startup Time** | <500ms | <1s | <2s |
-| **File Count** | ~50 | ~150 | ~350 |
-
-### Feature Comparison Matrix
-
-| Feature | Lite        | Standard                | Pro |
-|---------|-------------|-------------------------|-----|
-| **Agents (Total)** | 4           | 14                      | 13 |
-| **Document Processing** | PDF (basic) | PDF/DOCX/XLSX/PPTX      | PDF/DOCX/XLSX/PPTX |
-| **Design Skills** | No          | Canvas/Theme/Brand      | Canvas/Theme/Brand |
-| **Content Creation** | No          | Internal Communications | Internal Communications |
-| **Integration** | No          | No                      | MCP Builder |
-| **Extensibility** | No          | No                      | Skill Creator |
-| **Testing** | No          | No                      | Web App Testing |
-| **Advanced Visuals** | No          | No                      | GIF/Art/Artifacts |
-| **Auto-Discovery** | Yes         | Yes                     | Yes |
-| **Multi-Agent Coordination** | Basic       | Full                    | Full |
-| **Command Interface** | Yes         | Yes                     | Yes |
-
-## Variant Decision Matrix
-
-Use this matrix to help select your variant:
-
-### Choose Lite If:
-
-- You're new to AI agents
-- You want to explore capabilities
-- You have limited disk space (<50MB available)
-- You only need basic document processing
-- You want minimal setup time
-- You're a single user learning
-- You value simplicity over features
-
-**Example Users:**
-- Students
-- Individual explorers
-- Resource-constrained environments
-- Proof-of-concept projects
-
-**Price:** Free
-
-### Choose Standard If:
-
-- You're building products and features
-- Your team needs multiple agent types
-- You want comprehensive document creation
-- You need design and branding capabilities
-- You want professional output (Word, PDF, presentations)
-- You're a product team or startup
-- You value completeness and team collaboration
-
-**Example Users:**
-- Product teams
-- Development teams
-- Small organizations
-- Content creators
-- Design teams
-- Startups
-
-**Price:** $9/month or $99/year
-
-### Choose Pro If:
-
-- You need all 14 skills
-- You want to build custom integrations (MCP)
-- You need advanced web app testing
-- You want to create custom skills
-- You need advanced visual capabilities
-- You're an enterprise
-- You want maximum flexibility and extensibility
-
-**Example Users:**
-- Enterprises
-- Technical teams
-- Integration-heavy projects
-- Custom development shops
-- Advanced users
-- Organizations with complex needs
-
-## Use Case Scenarios
-
-### Scenario 1: Solo Product Manager
-
-**Needs:**
-- Create PRDs
-- Track product strategy
-- Manage requirements
-
-**Best Variant:** **Standard**
-
-**Why:** Full Product Manager, Product Owner, and Orchestrator agents with document creation (DOCX, PDF).
-
-**Workflow:**
-1. Use Product Manager to create PRD
-2. Use Product Owner for user stories
-3. Export to DOCX
-4. Apply Brand Guidelines
-
----
-
-### Scenario 2: Cross-Functional Product Team
-
-**Needs:**
-- Product planning
-- Development coordination
-- Design and UX
-- Testing strategy
-- Project management
-
-**Best Variant:** **Standard**
-
-**Why:** Full agent suite with document and design skills for team collaboration.
-
-**Workflow:**
-1. Product Manager creates PRD
-2. Product Owner plans sprint
-3. UX Expert designs interface
-4. Full-Stack Developer implements
-5. QA Test Architect tests
-6. Scrum Master coordinates
-
----
-
-### Scenario 3: Startup Building Integrated Platform
-
-**Needs:**
-- Full product development
-- Custom integrations
-- Advanced testing
-- Custom skills and tools
-
-**Best Variant:** **Pro**
-
-**Why:** MCP Builder for integrations, Web App Testing for quality, Skill Creator for extensibility.
-
-**Workflow:**
-1. Standard workflow (as in Scenario 2)
-2. Plus: Build MCP servers for integrations
-3. Plus: Create custom skills for workflows
-4. Plus: Comprehensive web app testing
-5. Plus: Advanced visual prototyping
-
----
-
-### Scenario 4: Individual Developer Learning
-
-**Needs:**
-- Learn about agents
-- Explore capabilities
-- Minimal overhead
-
-**Best Variant:** **Lite**
-
-**Why:** Small size, quick setup, learn basics.
-
-**Upgrade Path:** Lite → Standard (when scaling)
-
-**Workflow:**
-1. Explore with Master agent
-2. Learn basic patterns
-3. Upgrade to Standard for more capability
-
----
-
-### Scenario 5: Enterprise with Multiple Teams
-
-**Needs:**
-- All agent types
-- All skills
-- Custom integrations
-- Multiple use cases
-- Advanced capabilities
-
-**Best Variant:** **Pro**
-
-**Why:** Complete feature set, maximum flexibility, supports all use cases.
-
-**Workflow:**
-- Product teams: Full toolkit
-- Development teams: Full toolkit + MCP/Testing
-- Design teams: Design and Artifacts skills
-- Operations: Document processing and communications
-- Integration teams: MCP Builder
-
----
-
-## Upgrade Path
-
-### Lite to Standard
-
-**When to upgrade:**
-- You need multiple agents
-- You need document creation beyond PDF
-- Your team grows
-- You need design capabilities
-
-**Process:**
-1. Uninstall Lite variant
-2. Install Standard variant
-3. All previous work remains
-4. New agents and skills immediately available
-
-**Cost:** Transition from Free to $9/month
-
-### Standard to Pro
-
-**When to upgrade:**
-- You need custom integrations (MCP)
-- You need advanced testing (Web App Testing)
-- You want to create custom skills
-- You need advanced visual tools
-
-**Process:**
-1. Install Pro variant (can run alongside Standard)
-2. New agents and skills immediately available
-3. Upgrade billing when ready
-4. All Standard capabilities remain
-
-**Cost:** Transition from $9/month to $29/month
-
-### Lite to Pro (Direct)
-
-**Possible but not recommended.** Better to go Lite → Standard → Pro for learning progression.
-
-**If you need Pro immediately:**
-1. Install Pro variant
-2. Start with Standard features
-3. Explore advanced features as needed
-
-## Feature Checklist for Your Needs
-
-Check which features you need:
-
-### Product & Strategy Features
-- [ ] Create PRDs - All variants have Product Manager
-- [ ] User stories - All variants have Product Owner
-- [ ] Market research - All variants have Business Analyst
-- [ ] Feature planning - All variants have Product Manager
-
-### Development Features
-- [ ] Code implementation - All variants have Full-Stack Developer
-- [ ] Architecture design - All variants have Holistic Architect
-- [ ] Testing strategy - All variants have QA Test Architect
-- [ ] Process tracking - All variants have Process Task List
-
-### Design & Visual Features
-- [ ] UI/UX design - All variants have UX Expert
-- [ ] Visual design - Standard/Pro with Canvas Design
-- [ ] Theming - Standard/Pro with Theme Factory
-- [ ] Brand compliance - Standard/Pro with Brand Guidelines
-
-### Document Features
-- [ ] PDF processing - All variants
-- [ ] Word documents - Standard/Pro only
-- [ ] Spreadsheets - Standard/Pro only
-- [ ] Presentations - Standard/Pro only
-
-### Integration Features
-- [ ] Build MCP servers - Pro only
-- [ ] Web app testing - Pro only
-- [ ] Create custom skills - Pro only
-- [ ] Advanced visuals - Pro only
-
-**Count your checked items:**
-- 0-5 items: Consider Lite
-- 6-15 items: Standard recommended
-- 16+ items or any Advanced: Pro recommended
-
-## Storage & Resource Availability
-
-**Limited Storage?**
-- Choose Lite (~2MB)
-- Standard takes ~8MB
-- Pro takes ~16MB
-
-**Limited Bandwidth?**
-- Lite downloads fastest
-- Standard reasonable download time
-- Pro may take 2-3 minutes on slow connections
-
-**Limited RAM/CPU?**
-- All variants are lightweight
-- Lite has minimal footprint
-- Pro loads all features but still efficient
-
-## Making Your Decision
-
-### Final Recommendation by Role
-
-- **Product Manager** - Standard minimum
-- **Designer/UX** - Standard minimum
-- **Developer** - Standard or Pro (Pro if integration work)
-- **QA/Test** - Standard or Pro (Pro for Web App Testing)
-- **Project Manager** - Standard minimum
-- **Business Analyst** - Standard minimum
-- **Solo/Learning** - Start with Lite
-- **Enterprise** - Pro recommended
-
-## After Choosing Your Variant
-
-Once you've chosen:
-
-1. **[Read QUICK-START.md](QUICK-START.md)** - 15-minute onboarding
-2. **[Explore AGENTS.md](AGENTS.md)** - Learn about agents
-3. **[Review SKILLS.md](SKILLS.md)** - Understand your skills
-4. **Start building** - Create your first PRD or task
-
-## Upgrading Later
-
-Your choice is not permanent:
-
-- **Easy to upgrade** - Install new variant, uninstall old
-- **No data loss** - All your work remains
-- **Flexible pricing** - Upgrade/downgrade monthly
-- **No lock-in** - Cancel anytime
-
----
-
-**Version:** 1.0.0
-**Last Updated:** Nov 2025
-
-Ready to start? Choose your variant and head to [QUICK-START.md](QUICK-START.md).