liteagents 2.4.0

package/docs/UPDATED_VARIANT_CONFIGURATION.md

@@ -0,0 +1,274 @@
+# Updated Variant Configuration
+
+**Date**: 2025-11-05
+**Applied to**: All 4 packages (Claude, Opencode, Ampcode, Droid)
+
+## Summary
+
+All packages now have **progressive variant configurations** with clear differentiation between Lite, Standard, and Pro.
+
+## New Component Counts
+
+| Variant  | Agents | Skills | Resources | Hooks | Total |
+|----------|--------|--------|-----------|-------|-------|
+| **LITE** | 4      | 7      | 6         | 2     | 19    |
+| **STANDARD** | 9  | 11     | 6         | 2     | 28    |
+| **PRO**  | 13     | 22     | 6         | 2     | 43    |
+
+### Previous Configuration (for comparison)
+| Variant  | Agents | Skills | Resources | Hooks | Total |
+|----------|--------|--------|-----------|-------|-------|
+| OLD LITE | 3      | 0      | 6         | 2     | 11    |
+| OLD STANDARD | 13 | 8      | 6         | 2     | 29    |
+| OLD PRO  | 13     | 22     | 6         | 2     | 43    |
+
+**Key Changes**:
+- LITE: Increased from 3 to 4 agents, added 7 skills (was 0)
+- STANDARD: Decreased from 13 to 9 agents, increased from 8 to 11 skills
+- PRO: Unchanged (all agents, all skills)
+
+---
+
+## LITE Variant (19 components)
+
+### Agents (4)
+1. `1-create-prd`
+2. `2-generate-tasks`
+3. `3-process-task-list`
+4. `master`
+
+### Skills (7)
+1. `docx` - Document processing
+2. `pdf` - PDF generation
+3. `code-review` - Code review assistance
+4. `brainstorming` - Idea generation
+5. `root-cause-tracing` - Debugging assistance
+6. `mcp-builder` - MCP server building
+7. `systematic-debugging` - Systematic debugging approach
+
+### Resources (6)
+- `agent-teams.yaml`
+- `checklists.md`
+- `data.md`
+- `task-briefs.md`
+- `templates.yaml`
+- `workflows.yaml`
+
+### Hooks (2)
+- `register-agents.js`
+- `session-start.js`
+
+### Use Case
+Essential workflow management with core document processing and debugging skills. Perfect for users who need comprehensive PRD/task management plus basic document and debugging capabilities.
+
+---
+
+## STANDARD Variant (28 components)
+
+### Agents (9)
+1. `1-create-prd`
+2. `2-generate-tasks`
+3. `3-process-task-list`
+4. `master`
+5. `orchestrator`
+6. `quality-assurance`
+7. `code-developer`
+8. `market-researcher`
+9. `ui-designer`
+
+### Skills (11)
+1. `docx` - Document processing
+2. `pdf` - PDF generation
+3. `code-review` - Code review assistance
+4. `brainstorming` - Idea generation
+5. `root-cause-tracing` - Debugging assistance
+6. `mcp-builder` - MCP server building
+7. `webapp-testing` - Web application testing
+8. `xlsx` - Spreadsheet processing
+9. `systematic-debugging` - Systematic debugging approach
+10. `verification-before-completion` - Pre-completion verification
+11. `skill-creator` - Create custom skills
+
+### Resources (6)
+- `agent-teams.yaml`
+- `checklists.md`
+- `data.md`
+- `task-briefs.md`
+- `templates.yaml`
+- `workflows.yaml`
+
+### Hooks (2)
+- `register-agents.js`
+- `session-start.js`
+
+### Use Case
+Complete workflow and development team with enhanced testing and validation skills. Ideal for professional developers and teams who need full coordination, QA, and comprehensive skill coverage.
+
+---
+
+## PRO Variant (43 components)
+
+### Agents (13) - ALL AGENTS
+1. `1-create-prd`
+2. `2-generate-tasks`
+3. `3-process-task-list`
+4. `market-researcher`
+5. `code-developer`
+6. `system-architect`
+7. `master`
+8. `orchestrator`
+9. `feature-planner`
+10. `backlog-manager`
+11. `quality-assurance`
+12. `story-writer`
+13. `ui-designer`
+
+### Skills (22) - ALL SKILLS
+**Core Skills (from Lite):**
+1. `docx`
+2. `pdf`
+3. `code-review`
+4. `brainstorming`
+5. `root-cause-tracing`
+6. `mcp-builder`
+7. `systematic-debugging`
+
+**Additional Standard Skills:**
+8. `webapp-testing`
+9. `xlsx`
+10. `verification-before-completion`
+11. `skill-creator`
+
+**Advanced Pro-Only Skills:**
+12. `algorithmic-art` - Generate artistic algorithms
+13. `artifacts-builder` - Build Claude artifacts
+14. `brand-guidelines` - Brand guideline creation
+15. `canvas-design` - Canvas design tools
+16. `condition-based-waiting` - Conditional waiting patterns
+17. `internal-comms` - Internal communications
+18. `pptx` - PowerPoint generation
+19. `slack-gif-creator` - Slack GIF creation
+20. `test-driven-development` - TDD workflows
+21. `testing-anti-patterns` - Testing anti-pattern detection
+22. `theme-factory` - Theme generation
+
+### Resources (6)
+- `agent-teams.yaml`
+- `checklists.md`
+- `data.md`
+- `task-briefs.md`
+- `templates.yaml`
+- `workflows.yaml`
+
+### Hooks (2)
+- `register-agents.js`
+- `session-start.js`
+
+### Use Case
+Complete installation with all capabilities. For power users, enterprises, and teams requiring the full feature set including advanced creative, testing, and automation skills.
+
+---
+
+## Progressive Feature Matrix
+
+| Feature Category | Lite | Standard | Pro |
+|------------------|------|----------|-----|
+| **Workflow Management** | ✅ PRD, Tasks, Processing | ✅ + Orchestration | ✅ + Full Team |
+| **Document Processing** | ✅ Word, PDF | ✅ + Excel | ✅ + PowerPoint |
+| **Code Quality** | ✅ Review, Debugging | ✅ + Testing, Verification | ✅ + TDD, Anti-patterns |
+| **Development Tools** | ✅ MCP Builder | ✅ + Skill Creator | ✅ + Artifacts |
+| **Creative Tools** | ❌ | ❌ | ✅ Art, Design, Themes |
+| **Collaboration** | ❌ | ❌ | ✅ Slack, Comms |
+| **Architecture** | ❌ | ❌ | ✅ Holistic Architect |
+| **Product Management** | ❌ | ❌ | ✅ PM, PO, Scrum Master |
+
+---
+
+## Rationale
+
+### Why These Changes?
+
+**LITE Enhancement:**
+- **Old**: Only 3 coordination agents, no skills → Too minimal
+- **New**: 4 workflow agents + 7 essential skills → Useful for real work
+- **Impact**: Users can now do meaningful development work with Lite
+
+**STANDARD Refinement:**
+- **Old**: All 13 agents (same as Pro) → No differentiation
+- **New**: 9 agents focused on development team → Clear value proposition
+- **Impact**: Better suited for professional teams without unnecessary complexity
+
+**PRO Maintained:**
+- **Unchanged**: Still includes everything
+- **Differentiation**: Now clearly distinct from Standard (13 vs 9 agents, 22 vs 11 skills)
+
+---
+
+## Migration Notes
+
+### For Existing Users
+
+**If upgrading from old Lite to new Lite:**
+- ✅ Gain: 1 additional agent (1-create-prd, 2-generate-tasks, 3-process-task-list)
+- ✅ Gain: 7 new skills
+- ⚠️ Change: Lost orchestrator and story-writer (moved to Standard)
+
+**If upgrading from old Standard to new Standard:**
+- ⚠️ Change: Reduced from 13 to 9 agents
+- ✅ Gain: 3 additional skills (verification-before-completion, skill-creator, webapp-testing)
+- Lost agents: feature-planner, backlog-manager, story-writer, system-architect (moved to Pro only)
+
+**If using Pro:**
+- ✅ No changes - still includes everything
+
+---
+
+## Testing Impact
+
+### Test Updates Required
+
+1. **variant-testing.test.js** - Update expected counts:
+   ```javascript
+   const EXPECTED_COUNTS = {
+     lite: { agents: 4, skills: 7, resources: 6, hooks: 2 },
+     standard: { agents: 9, skills: 11, resources: 6, hooks: 2 },
+     pro: { agents: 13, skills: 22, resources: 6, hooks: 2 }
+   };
+   ```
+
+2. **LITE_AGENTS** constant update:
+   ```javascript
+   const LITE_AGENTS = [
+     '1-create-prd.md',
+     '2-generate-tasks.md',
+     '3-process-task-list.md',
+     'master.md'
+   ];
+   ```
+
+3. **STANDARD_SKILLS** constant update:
+   ```javascript
+   const STANDARD_SKILLS = [
+     'docx', 'pdf', 'code-review', 'brainstorming',
+     'root-cause-tracing', 'mcp-builder', 'webapp-testing',
+     'xlsx', 'systematic-debugging', 'verification-before-completion',
+     'skill-creator'
+   ];
+   ```
+
+---
+
+## Documentation Updates Required
+
+1. **README.md** - Update variant descriptions and counts
+2. **INSTALLER_GUIDE.md** - Update variant tables with new counts
+3. **VARIANT_CONFIGURATION.md** - Update skill rationale
+4. **INSTALLATION_DEMO.md** - Update ASCII art demos with new counts
+5. **CHANGELOG.md** - Add entry for variant reconfiguration
+
+---
+
+**Applied**: 2025-11-05
+**Status**: ✅ Complete - All 4 packages updated
+**Next**: Re-run tests with updated expected counts
+

package/docs/VARIANT_CONFIGURATION.md

@@ -0,0 +1,440 @@
+# Variant Configuration Guide
+
+**Purpose:** This document explains the rationale for variant configurations and skill selection across all agentflow tools (Claude, Opencode, Ampcode, Droid).
+
+**Last Updated:** 2025-11-04
+
+---
+
+## Table of Contents
+
+1. [Variant Philosophy](#variant-philosophy)
+2. [Core Skills Selection](#core-skills-selection)
+3. [Variant Breakdown](#variant-breakdown)
+4. [Tool-Specific Optimizations](#tool-specific-optimizations)
+5. [Usage Recommendations](#usage-recommendations)
+
+---
+
+## Variant Philosophy
+
+The agentflow installer offers **three variant levels** to accommodate different user needs and resource constraints:
+
+### Design Principles
+
+1. **Progressive Capability:** Each variant builds upon the previous, adding functionality without removing features
+2. **Clear Use Cases:** Each variant targets specific user personas and workflows
+3. **Resource Optimization:** Variants minimize disk space and cognitive load while maximizing value
+4. **Consistent Core:** All tools share the same variant structure for predictability
+
+### Variant Tiers
+
+| Variant | Agents | Skills | Target Users | Disk Space |
+|---------|--------|--------|--------------|------------|
+| **Lite** | 3 core | 0 | Beginners, evaluators, minimal setup | ~5-10 MB |
+| **Standard** | All (13) | 8 core | Professional developers, teams | ~50-100 MB |
+| **Pro** | All (13) | All (22) | Power users, enterprises | ~150-200 MB |
+
+---
+
+## Core Skills Selection
+
+The **8 core skills** included in the Standard variant were selected based on:
+
+### Selection Criteria
+
+1. **Universal Applicability:** Skills useful across all development workflows
+2. **Professional Necessity:** Capabilities required for professional development work
+3. **Document Processing:** Essential document creation and manipulation
+4. **Design Integration:** Basic design and branding capabilities
+5. **Communication Support:** Internal communication and documentation needs
+
+### The 8 Core Skills
+
+#### Document Processing Skills (4)
+
+**1. pdf**
+- **Purpose:** PDF manipulation, form filling, document generation
+- **Rationale:** PDFs are ubiquitous in professional workflows (contracts, reports, forms)
+- **Use Cases:** Invoice generation, form automation, document archival
+- **Size:** ~2 MB (scripts, reference docs)
+
+**2. docx**
+- **Purpose:** Microsoft Word document creation and editing
+- **Rationale:** Word is the standard for collaborative document editing
+- **Use Cases:** Technical documentation, proposals, reports, templates
+- **Size:** ~8 MB (OOXML schemas, validation scripts)
+
+**3. xlsx**
+- **Purpose:** Excel spreadsheet operations
+- **Rationale:** Spreadsheets essential for data analysis and reporting
+- **Use Cases:** Data exports, financial reports, automated dashboards
+- **Size:** ~500 KB (Python libraries, recalc scripts)
+
+**4. pptx**
+- **Purpose:** PowerPoint presentation creation
+- **Rationale:** Presentations required for stakeholder communication
+- **Use Cases:** Project updates, design presentations, pitch decks
+- **Size:** ~8 MB (OOXML schemas, HTML conversion)
+
+#### Design & Branding Skills (3)
+
+**5. canvas-design**
+- **Purpose:** Graphics, diagrams, and visual content creation
+- **Rationale:** Visual communication essential for modern development
+- **Use Cases:** Architecture diagrams, social media graphics, infographics
+- **Size:** ~15 MB (50+ fonts, templates)
+- **Note:** Largest skill due to font library
+
+**6. theme-factory**
+- **Purpose:** Design theme generation (colors, typography, branding)
+- **Rationale:** Consistent branding required across professional projects
+- **Use Cases:** Design systems, brand identity, UI theming
+- **Size:** ~1 MB (theme templates, showcase)
+
+**7. brand-guidelines**
+- **Purpose:** Brand guideline document generation
+- **Rationale:** Brand documentation essential for team alignment
+- **Use Cases:** Style guides, brand handoffs, design documentation
+- **Size:** ~100 KB (templates)
+
+#### Communication Skill (1)
+
+**8. internal-comms**
+- **Purpose:** Internal communication content (newsletters, updates, FAQs)
+- **Rationale:** Team communication foundational to all projects
+- **Use Cases:** Release notes, team announcements, documentation
+- **Size:** ~200 KB (templates, examples)
+
+### Skills Excluded from Standard (14)
+
+These advanced skills are available only in the **Pro variant**:
+
+**Development Skills:**
+- `artifacts-builder` - Web artifact creation (React, Tailwind)
+- `code-review` - Automated code review
+- `mcp-builder` - MCP server builder
+- `skill-creator` - Create new skills
+
+**Testing & Debugging:**
+- `condition-based-waiting` - Test wait conditions
+- `root-cause-tracing` - Bug root cause analysis
+- `systematic-debugging` - Structured debugging
+- `test-driven-development` - TDD methodology
+- `testing-anti-patterns` - Test anti-pattern detection
+- `webapp-testing` - Playwright web testing
+
+**Creative Skills:**
+- `algorithmic-art` - Generative art
+- `slack-gif-creator` - Animated GIF creation
+
+**Workflow Skills:**
+- `brainstorming` - Facilitated brainstorming
+- `verification-before-completion` - Pre-completion checks
+
+**Rationale for Exclusion:**
+- Specialized use cases (not universally needed)
+- Advanced/power user features
+- Niche workflows (algorithmic art, GIF creation)
+- Development-specific tools (MCP, artifacts)
+
+---
+
+## Variant Breakdown
+
+### Lite Variant
+
+**Purpose:** Minimal installation for evaluation and basic workflow management
+
+**Included:**
+- 3 agents: `master`, `orchestrator`, `story-writer`
+- 0 skills
+- All resources (agent-teams.yaml, checklists.md, etc.)
+- All hooks
+
+**Use Cases:**
+- Try agentflow with minimal commitment
+- Learn the agent system before full installation
+- Limited resource environments (cloud VMs, containers)
+- Quick setup for demonstrations
+
+**Capabilities:**
+- Task execution and management
+- Multi-agent workflows
+- Agile sprint management
+- Resource-driven operations (checklists, templates)
+
+**Limitations:**
+- No document processing
+- No design capabilities
+- No specialized skills
+- Basic workflow support only
+
+### Standard Variant (Recommended)
+
+**Purpose:** Balanced installation for professional development
+
+**Included:**
+- 13 agents: All agents (master, orchestrator, specialized domain agents)
+- 8 skills: Core document processing and design (pdf, docx, xlsx, pptx, canvas-design, theme-factory, brand-guidelines, internal-comms)
+- All resources
+- All hooks
+
+**Use Cases:**
+- Professional software development
+- Team collaboration
+- Document creation and automation
+- Design and branding work
+- 90% of user workflows
+
+**Capabilities:**
+- Full agent suite (PRD creation, task generation, development, QA, UX)
+- Complete document processing pipeline
+- Design and branding support
+- Internal communication tools
+- Resource and template management
+
+**Recommended For:**
+- Professional developers
+- Development teams
+- Consultants and agencies
+- Anyone doing serious development work
+
+### Pro Variant
+
+**Purpose:** Complete installation with all capabilities
+
+**Included:**
+- 13 agents: All agents
+- 22 skills: All skills (8 core + 14 advanced)
+- All resources
+- All hooks
+
+**Use Cases:**
+- Power users needing every capability
+- Enterprise teams with diverse needs
+- Development teams doing advanced testing
+- Creative workflows requiring algorithmic art/GIFs
+- MCP server development
+- Custom skill creation
+
+**Capabilities:**
+- Everything in Standard, plus:
+- Advanced testing (Playwright, condition-based waiting)
+- Debugging tools (root cause tracing, systematic debugging)
+- Creative tools (algorithmic art, GIF creation)
+- Development tools (MCP builder, artifact builder)
+- Skill creation and customization
+
+**Recommended For:**
+- Power users
+- Enterprises
+- Teams with comprehensive requirements
+- Users exploring all capabilities
+
+---
+
+## Tool-Specific Optimizations
+
+While all tools share the same variant structure and core skills, each has optimizations:
+
+### Claude (Conversational AI)
+- **Optimization:** `conversational-ai`
+- **Focus:** Natural language interactions, markdown-first
+- **Strengths:** Extensive documentation, conversational tone
+- **Best For:** Teams preferring conversational interfaces
+
+### Opencode (CLI-Optimized)
+- **Optimization:** `cli-codegen`
+- **Focus:** Terminal-first workflows, command-line integration
+- **Strengths:** Fast execution, scriptable, automation-ready
+- **Best For:** CLI power users, terminal enthusiasts, DevOps
+
+### Ampcode (Amplified Development)
+- **Optimization:** `amplified-codegen`
+- **Focus:** Maximum velocity, automation-focused
+- **Strengths:** Rapid development, high throughput
+- **Best For:** Teams focused on velocity, fast-paced projects
+
+### Droid (Mobile Development)
+- **Optimization:** `mobile-codegen`
+- **Focus:** Android-first, mobile patterns
+- **Strengths:** Mobile-specific workflows, Android Studio integration
+- **Best For:** Android developers, mobile development teams
+
+---
+
+## Usage Recommendations
+
+### Choosing a Variant
+
+**Start with Lite if:**
+- You're evaluating agentflow for the first time
+- You have limited disk space (< 50 MB available)
+- You only need basic workflow management
+- You want to learn the system before full installation
+
+**Choose Standard if:**
+- You're a professional developer (90% of users)
+- You need document processing capabilities
+- You work on team projects requiring design/branding
+- You want the "recommended" configuration
+- You have 50-100 MB disk space available
+
+**Choose Pro if:**
+- You need every capability
+- You're doing advanced testing or debugging
+- You're building custom skills or MCP servers
+- You have specialized creative needs (art, GIFs)
+- You have 150-200 MB disk space available
+- You're an enterprise with diverse requirements
+
+### Upgrading Between Variants
+
+The installer supports seamless upgrades:
+
+```bash
+# Upgrade from Lite to Standard
+node installer/cli.js --upgrade claude standard
+
+# Upgrade from Standard to Pro
+node installer/cli.js --upgrade claude pro
+
+# Downgrade from Pro to Standard (if needed)
+node installer/cli.js --upgrade claude standard
+```
+
+**Upgrade Process:**
+- Automatic backup created before upgrade
+- Only adds/removes differential files
+- Preserves user-created content
+- Updates manifest with new variant metadata
+
+### Choosing a Tool
+
+**Choose Claude if:**
+- You prefer conversational interfaces
+- You value extensive documentation
+- You're comfortable with markdown-first workflows
+
+**Choose Opencode if:**
+- You're a CLI power user
+- You prefer terminal-based workflows
+- You need scriptable, automatable processes
+
+**Choose Ampcode if:**
+- You prioritize development velocity
+- You need maximum throughput
+- You're focused on rapid iteration
+
+**Choose Droid if:**
+- You're developing Android applications
+- You need mobile-specific patterns
+- You work in Android Studio
+
+### Multi-Tool Installation
+
+You can install multiple tools simultaneously:
+
+```bash
+# Install both Claude (standard) and Opencode (lite)
+node installer/cli.js --tools claude,opencode --variant standard
+
+# Install to custom paths
+node installer/cli.js --tools claude --path claude=~/.claude-ai
+```
+
+---
+
+## Maintenance and Updates
+
+### Skill Updates
+
+Skills are updated independently of agents:
+
+- **Minor Updates:** Bug fixes, improved documentation
+- **Major Updates:** New features, breaking changes
+- **Deprecations:** Announced 6 months in advance
+
+### Variant Evolution
+
+As agentflow evolves, variant definitions may change:
+
+**Standard Variant Philosophy:**
+- Will always include essential document processing (pdf, docx, xlsx, pptx)
+- May add new "core" skills if universally useful
+- Will maintain ~8-12 skills to balance capability vs. bloat
+
+**Pro Variant Philosophy:**
+- Will include all available skills (no limit)
+- New experimental skills added here first
+- Power users get early access to new capabilities
+
+---
+
+## Customization
+
+### Custom Variants
+
+Advanced users can create custom `variants.json` configurations:
+
+```json
+{
+  "custom": {
+    "name": "Custom",
+    "description": "My custom variant",
+    "useCase": "Specific to my workflow",
+    "targetUsers": "Me",
+    "agents": ["master", "orchestrator", "code-developer"],
+    "skills": ["pdf", "docx", "code-review", "webapp-testing"],
+    "resources": "*",
+    "hooks": "*"
+  }
+}
+```
+
+Then install with:
+```bash
+node installer/cli.js --variant custom
+```
+
+### Skill-Specific Installation
+
+While not officially supported, you can manually add specific skills:
+
+1. Install desired variant
+2. Manually copy skill directories from another installation
+3. Update `manifest.json` to include new skills
+
+---
+
+## Summary
+
+**Key Takeaways:**
+
+1. **Three Variants:** Lite (minimal), Standard (recommended), Pro (complete)
+2. **8 Core Skills:** Document processing (pdf, docx, xlsx, pptx) + Design (canvas-design, theme-factory, brand-guidelines) + Communication (internal-comms)
+3. **Standard for Most:** 90% of users should choose Standard variant
+4. **Tool-Specific:** Each tool optimized for different workflows (conversational, CLI, amplified, mobile)
+5. **Upgradeable:** Easy to upgrade between variants as needs change
+
+**Configuration Files:**
+- `packages/claude/variants.json` - Claude variant definitions
+- `packages/opencode/variants.json` - Opencode variant definitions
+- `packages/ampcode/variants.json` - Ampcode variant definitions
+- `packages/droid/variants.json` - Droid variant definitions
+
+**Related Documentation:**
+- `docs/PACKAGE_BASELINE.md` - Claude package structure reference
+- `installer/README.md` - Installation instructions
+- `docs/INSTALLER_GUIDE.md` - Comprehensive installer guide (coming in Phase 7.0)
+
+---
+
+## Version History
+
+- **2025-11-04:** Initial documentation
+  - Documented 8 core skills rationale
+  - Explained variant philosophy
+  - Provided usage recommendations
+  - Documented tool-specific optimizations