liteagents 2.4.0

package/CHANGELOG.md

@@ -0,0 +1,441 @@
+# Changelog
+
+All notable changes to Agentic Kit will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Planned
+- Community marketplace submissions
+- Additional skills for data analysis
+- Enhanced testing capabilities
+- Performance optimizations
+
+---
+
+## [2.3.0] - 2026-01-22
+
+### Removed
+- Removed `subagent-spawning` skill (functionality integrated into agents)
+
+### Changed
+- Updated command/skill count from 21 to 20 across all documentation
+- README.md: Updated command counts and removed subagent-spawning from skill list
+- installer/cli.js: Updated welcome banner to reflect 20 commands
+- package.json: Updated description to reflect 20 commands
+- packages/subagentic-manual.md: Updated command counts
+
+---
+
+## [1.11.1] - 2026-01-20
+
+### Fixed
+- Added missing command definitions to `packages/opencode/opencode.jsonc` (debug, explain, git-commit, optimize, refactor, review, security, ship, stash, test-generate, subagent-spawning)
+
+---
+
+## [1.11.0] - 2026-01-20
+
+### Added
+- `/stash` command for saving session context for compaction recovery or handoffs (added to all packages: claude, opencode, ampcode, droid)
+
+### Changed
+- Updated command count from 20 to 21 across all documentation
+- README.md: Updated command counts and added stash to command list
+- installer/cli.js: Updated welcome banner to reflect 21 commands
+- package.json: Updated description to reflect 21 commands
+
+### Fixed
+- package.json: Fixed validate script path to point to scripts/validate-package.js
+
+---
+
+## [1.2.1] - 2025-11-05
+
+### Changed
+
+**Package Optimization:**
+- Optimized npm package structure by excluding development-only files
+- Updated `package.json` "files" field to exclude `tests/` and `scripts/` directories
+- Removed outdated references to pre-1.2.0 structure (`.claude-plugin/`, root `agents/`, `skills/`, `hooks/`)
+- Added cleanup npm scripts: `npm run clean` and `npm run clean:git`
+- Updated `prepublishOnly` script to auto-clean test artifacts before validation
+
+**Repository Cleanup:**
+- Removed 916 temporary test artifacts (22 MB reduction)
+- Updated `.gitignore` to prevent future test artifact commits
+- Added comprehensive `REPOSITORY_AUDIT.md` with detailed analysis
+
+**Results:**
+- Repository size reduced: 70 MB → 49 MB (30% reduction)
+- File count reduced: 2,727 → 1,812 files (33% reduction)
+- Tests directory optimized: 959 → 43 files (96% cleanup)
+- npm package size: 38.4 MB unpacked (1,385 files only)
+- Published package now contains only essential user-facing files
+- 35% faster installation for end users
+
+---
+
+## [1.2.0] - 2025-11-05
+
+### Added
+
+**Interactive Multi-Tool Installer:**
+- `installer/cli.js` - Interactive CLI with 4-step installation process
+- `installer/package-manager.js` - Variant-based package management
+- `installer/installation-engine.js` - File copying with rollback capability
+- `installer/verification-system.js` - Post-installation validation
+- `installer/path-manager.js` - Path resolution and validation
+- `installer/state-manager.js` - Resume capability for interrupted installations
+- Command-line interface supporting 4 tools: Claude, Opencode, Ampcode, Droid
+- Real-time progress tracking with ANSI progress bars
+- Variant selection (Lite: 510 KB, Standard: 8.4 MB, Pro: 9 MB)
+- Multi-tool installation (install all 4 tools simultaneously)
+- Silent mode for CI/CD (`--silent --variant=standard --tools=claude`)
+- Custom path configuration with validation
+- Automatic rollback on installation failure
+- Resume capability for interrupted installations
+- Uninstall functionality (`--uninstall --tools=claude`)
+- Upgrade/downgrade between variants
+
+**Installation Reporting & Telemetry (Phase 9.2-9.3):**
+- `installer/report-template.js` - Comprehensive installation report generation
+  - Summary with success/failure status, variant, tool count, total files, installation time
+  - Detailed per-tool information (components, paths, verification status)
+  - System information (Node.js version, platform, architecture)
+  - Errors and warnings sections
+  - Reports saved to `~/.agentic-kit-install.log`
+- `installer/telemetry.js` - Anonymous usage statistics (opt-in only)
+  - User consent prompt with clear data collection policy
+  - `--no-telemetry` flag to disable telemetry
+  - Collects: variant, tool count, installation time, success/failure, OS type
+  - Does NOT collect: file paths, personal information, specific tool names
+  - Local storage only (not sent to servers)
+  - Easy opt-out via config file or command flag
+- `docs/PRIVACY.md` - Transparent privacy policy (250+ lines)
+  - Detailed explanation of data collection
+  - What we collect vs. what we don't collect
+  - How to manage consent and opt-out
+  - View and delete collected data
+
+**Security Hardening (Phase 9.4):**
+- `docs/SECURITY.md` - Comprehensive security documentation (380+ lines)
+  - Security principles and implemented measures
+  - Path traversal prevention with `PathManager.sanitizePath()`
+  - Symlink attack mitigation with real path resolution
+  - Input validation for all user inputs (tool names, variants, paths)
+  - File size limits (1MB max) to prevent DoS attacks
+  - Null byte detection in paths and file content
+  - Secure file permissions (0600) for sensitive files
+  - No command injection vulnerabilities (no shell execution of user input)
+- Enhanced `PathManager` with security checks:
+  - Validates paths are within home directory
+  - Checks for suspicious system directories
+  - Resolves and validates symlinks
+  - Prevents null byte injection
+- Enhanced `PackageManager` with JSON validation:
+  - File size limits before parsing
+  - Null byte detection
+  - Structure validation (must be object)
+  - Safe error handling
+
+**Legacy Migration Support (Phase 9.5):**
+- `docs/MIGRATION.md` - Complete migration guide (400+ lines)
+  - Automatic and manual migration procedures
+  - Variant classification from legacy installations
+  - Troubleshooting and rollback instructions
+  - FAQ and version compatibility matrix
+- `PathManager.detectLegacyInstallation()` - Automatic detection of pre-1.2.0 installations
+- `PathManager.countLegacyComponents()` - Component counting for variant classification
+- `PathManager.classifyVariantFromComponents()` - Smart variant classification
+- `PathManager.createManifestForLegacy()` - Manifest generation for legacy installations
+- Preserves user customizations during migration
+
+**Tool-Specific Packages:**
+- `packages/claude/` - Conversational AI optimization (markdown-first)
+- `packages/opencode/` - CLI-optimized code generation (terminal-first)
+- `packages/ampcode/` - Amplified development (maximum velocity)
+- `packages/droid/` - Android-first mobile development
+- Tool-specific hooks with optimization flags
+- Consistent structure: 13 agents, 22 skills (8 core + 14 advanced)
+- Variant configuration via `variants.json` for each tool
+
+**Comprehensive Testing:**
+- `tests/installer/variants-parsing.test.js` - 88 tests for variant parsing
+- `tests/installer/package-manager.test.js` - 44 tests for package management
+- `tests/installer/installation-engine.test.js` - 35 tests for installation
+- `tests/installer/integration.test.js` - 40 comprehensive integration tests
+- `tests/installer/path-confirmation.test.js` - 34 tests for path validation
+- `tests/installer/summary-display.test.js` - 13 tests for summary display
+- `tests/validation-test.js` - 9 core module validation tests (Phase 9.6)
+  - Package Manager, Path Manager, Installation Engine initialization
+  - Variant configuration loading
+  - Path sanitization and security (path traversal protection)
+  - Report generation, telemetry, legacy detection, state management
+- Total: 263 passing tests with zero failures
+- 100% validation success rate across all packages
+
+**Documentation:**
+- `docs/INSTALLER_GUIDE.md` - Comprehensive installation guide (850+ lines)
+  - Step-by-step installation process
+  - Variant selection guide with use cases
+  - Tool selection guide (when to use each tool)
+  - Custom path configuration
+  - 7 common installation scenarios
+  - Command-line flags reference
+  - Troubleshooting (7 common issues with solutions)
+  - FAQ (40+ questions)
+- `docs/VARIANT_CONFIGURATION.md` - Variant system documentation (440 lines)
+  - Variant philosophy and design principles
+  - Detailed rationale for 8 core skills
+  - Explanation of 14 advanced skills (Pro only)
+  - Tool-specific optimizations
+  - Usage recommendations
+- `docs/PACKAGE_BASELINE.md` - Package structure reference (557 lines)
+- `docs/PACKAGE_VALIDATION_REPORT.md` - Quality assurance report (400+ lines)
+  - All 12 tool/variant combinations validated
+  - Zero errors, zero warnings
+  - Production-ready status confirmed
+
+**Scripts:**
+- `scripts/validate-all-packages.js` - Automated validation for all packages
+- `validation-results.json` - Machine-readable validation results
+
+### Changed
+
+**README.md:**
+- Updated from 14 to 22 skills
+- Added tool badges (Claude, Opencode, Ampcode, Droid)
+- Interactive installer promoted to recommended installation method
+- Added "Supported Tools" section
+- Added Size column to variants table
+- Updated installation options with multi-tool support
+- Updated Stats section (22 skills, 4 tools)
+
+**Skills:**
+- Expanded from 14 to 22 total skills
+- 8 core skills (Standard): pdf, docx, xlsx, pptx, canvas-design, theme-factory, brand-guidelines, internal-comms
+- 14 advanced skills (Pro only): video-production, audio-transcription, data-visualization, web-scraping, api-integration, database-query, machine-learning, blockchain-tools, iot-integration, security-audit, performance-profiling, devops-automation, cloud-deployment, code-migration
+
+**Architecture:**
+- Multi-tool support with isolated installations
+- Each tool has tool-specific optimization flags
+- Consistent variant system across all tools
+- Centralized package validation
+
+### Fixed
+
+- Package validation for all 12 tool/variant combinations
+- Skills directory filtering (excluded README.md from skills list)
+- Directory naming consistency (agents/, skills/, resources/, hooks/)
+- Path validation with proper tilde expansion
+- Integration tests for uninstall, multi-tool, upgrade/downgrade scenarios
+
+### Technical Details
+
+**Installation Capabilities:**
+- Average installation time: Lite (10s), Standard (30s), Pro (60s)
+- Supports offline installation (no internet required after npm install)
+- Atomic operations with full rollback on failure
+- Cross-platform support (Linux, macOS, Windows)
+- Validation of 486+ files across all packages
+- Exit codes for scripting (0=success, 1-6=various errors)
+
+**Package Sizes:**
+- Lite: ~510 KB (3 agents, 0 skills, 11 files)
+- Standard: ~8.4 MB (13 agents, 8 skills, 29 files)
+- Pro: ~9 MB (13 agents, 22 skills, 43 files)
+
+**Command-Line Flags:**
+- `--variant` - Specify variant (lite, standard, pro)
+- `--tools` - Specify tools (claude, opencode, ampcode, droid, all)
+- `--path` - Custom installation path
+- `--silent` / `--yes` - Non-interactive mode
+- `--config` - Load configuration from file
+- `--uninstall` - Remove installed tools
+- `--upgrade` - Upgrade to different variant
+
+---
+
+## [1.1.0] - 2025-11-02
+
+### Added
+
+**Session Persistence:**
+- `session-start.js` hook - Auto-loads skills on every Claude Code session start
+- Startup banner showing loaded agents and skills
+- Persistent skills across sessions (inspired by superpowers)
+
+**Documentation:**
+- `KNOWLEDGE_BASE.md` - Comprehensive reference (consolidated from 4 files)
+- `PUBLISHING.md` - Complete publishing guide
+- `UPDATE_VERSION.sh` - Automated version management
+- Streamlined `README.md` (70% shorter, focused on quick start)
+- Organized all docs under `docs/` directory
+
+**Infrastructure:**
+- `.claude-plugin/marketplace.json` - Official marketplace catalog
+- npm version badge in README
+
+### Changed
+- Agent invocation syntax to lowercase with hyphens (`@feature-planner:` not `@ProductManager:`)
+- npx clarification - Clearly states it runs temporarily without installing
+- README structure - Now quick start focused, links to detailed docs in `docs/`
+
+### Fixed
+- Skill count - Corrected Pro variant from 16 to 14 skills
+- Repository URLs - Updated to `github.com/amrhas82/agentflow`
+- Author info - Updated to `amrhas82 <avoidaccess@msn.com>`
+- All variant manifests - Added session-start hook
+
+### Removed
+- Consolidated `AGENTS.md`, `ARCHITECTURE.md`, `SKILLS.md` into `KNOWLEDGE_BASE.md`
+
+---
+
+## [1.0.0] - 2025-11-02
+
+### Added - Initial Release
+
+**Core Features:**
+- 13 specialized agents (Master, Orchestrator, Product Manager, etc.)
+- 14 powerful skills (PDF, DOCX, Canvas Design, MCP Builder, etc.)
+- 3 variants: Lite (3 agents), Standard (13 agents, 8 skills), Pro (13 agents, 14 skills)
+
+**Distribution:**
+- npm package: `agentflow`
+- GitHub: `github.com/amrhas82/agentflow`
+- Direct install: `/plugin add github:amrhas82/agentic-kit`
+- npx support: `npx agentflow` or `npx agkit`
+
+**Infrastructure:**
+- Plugin manifests for each variant
+- Auto-discovery via `register-agents.js` hook
+- Variant isolation
+- Validation scripts (`validate-package.js`, `validate-references.sh`)
+
+**Documentation:**
+- README, QUICK-START, AGENTS, SKILLS, VARIANTS, TROUBLESHOOTING, CONTRIBUTING
+
+---
+
+## Upgrade Guide
+
+### From 1.2.1 to 1.11.0
+
+**No breaking changes.** Added new `/stash` command for session context management.
+
+**New:**
+- `/stash` command for saving session context
+- Updated command count from 20 to 21
+
+**Action Required:**
+- None for existing installations - upgrade is seamless
+
+**To Upgrade:**
+```bash
+# Via npm
+npm install -g agentflow@latest
+
+# Run installer
+agentic-kit
+```
+
+---
+
+### From 1.1.0 to 1.2.0
+
+**No breaking changes.** Major new feature: Interactive Multi-Tool Installer.
+
+**New:**
+- Interactive installer for Claude, Opencode, Ampcode, and Droid
+- 22 total skills (expanded from 14)
+- Multi-tool support with isolated installations
+- Comprehensive testing suite (254 tests)
+- Extensive documentation (INSTALLER_GUIDE.md, VARIANT_CONFIGURATION.md)
+- Package validation system
+
+**Action Required:**
+- None for existing installations - upgrade is seamless
+- **New users**: Use interactive installer (`npm install -g agentflow && agentic-kit install`)
+- **Existing users**: Continue using existing installation methods
+
+**To Upgrade:**
+```bash
+# Via GitHub
+/plugin update github:amrhas82/agentic-kit
+
+# Via npm
+npm update agentflow
+
+# Via npx (always latest)
+npx agentflow
+
+# New: Interactive installer
+npm install -g agentflow
+agentic-kit install
+```
+
+**What's Different:**
+- Skills count: 14 → 22 (8 core + 14 advanced in Pro)
+- Installation methods: Now supports 4 tools (Claude, Opencode, Ampcode, Droid)
+- Variant sizes documented: Lite (510 KB), Standard (8.4 MB), Pro (9 MB)
+
+---
+
+### From 1.0.0 to 1.1.0
+
+**No breaking changes.** Features and documentation improvements only.
+
+**New:**
+- Skills auto-load on session start
+- Consolidated documentation in `docs/` directory
+- marketplace.json for distribution
+
+**Action Required:**
+- None - upgrade is seamless
+- Optional: Use lowercase agent syntax (`@master:` instead of `@Master:`)
+
+**To Upgrade:**
+```bash
+# Via GitHub
+/plugin update github:amrhas82/agentic-kit
+
+# Via npm
+npm update agentflow
+
+# Via npx (always latest)
+npx agentflow
+```
+
+---
+
+## Version History
+
+| Version | Date | Key Features |
+|---------|------|--------------|
+| **2.3.0** | 2026-01-22 | Removed subagent-spawning skill (20 commands) |
+| **1.11.1** | 2026-01-20 | Fixed missing commands in opencode.jsonc |
+| **1.11.0** | 2026-01-20 | Added /stash command (21 total commands) |
+| **1.2.1** | 2025-11-05 | Package optimization, repository cleanup |
+| **1.2.0** | 2025-11-05 | Interactive multi-tool installer, 22 skills, 4 tools support, 254 tests |
+| **1.1.0** | 2025-11-02 | Session persistence, docs consolidation, marketplace catalog |
+| **1.0.0** | 2025-11-02 | Initial release: 13 agents, 14 skills, 3 variants |
+
+---
+
+## Links
+
+- **GitHub**: https://github.com/amrhas82/agentflow
+- **npm**: https://www.npmjs.com/package/agentflow
+- **Issues**: https://github.com/amrhas82/agentflow/issues
+- **Releases**: https://github.com/amrhas82/agentflow/releases
+
+---
+
+**Maintained by**: amrhas82
+**License**: MIT

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Amr Hassan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+<div align="center">
+
+```
+          █████╗  ██████╗ ███████╗███╗   ██╗████████╗███████╗██╗      ██████╗ ██╗    ██╗
+         ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝██╔════╝██║     ██╔═══██╗██║    ██║
+         ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   █████╗  ██║     ██║   ██║██║ █╗ ██║
+         ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ██╔══╝  ██║     ██║   ██║██║███╗██║
+         ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ██║     ███████╗╚██████╔╝╚███╔███╔╝
+         ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝     ╚══════╝ ╚═════╝  ╚══╝╚══╝
+```
+
+**AI development toolkit with 11 specialized agents and 20 commands per tool**
+
+</div>
+
+[![npm version](https://img.shields.io/npm/v/agentflow)](https://www.npmjs.com/package/agentflow)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Supported Tools:**
+[![Claude](https://img.shields.io/badge/Claude-Supported-blue?logo=anthropic)](https://claude.ai)
+[![Opencode](https://img.shields.io/badge/Opencode-Supported-green)](https://github.com/amrhas82/opencode)
+[![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)
+
+Specialized AI agents and workflow commands for product management, agile development, and software engineering. Simple installer supports Claude, Opencode, Ampcode, and Droid.
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# Install
+npm install -g agentflow
+
+# Run installer
+agentflow
+
+# Choose tool(s): claude, opencode, ampcode, or droid
+# Each tool gets 11 agents + 20 commands
+```
+
+### Supported Tools
+
+- **Claude Code** - 11 subagents + 10 skills + 10 commands
+- **Opencode** - 11 agent references + 20 commands
+- **Ampcode** - 11 subagents + 10 skills + 10 commands
+- **Droid** - 11 agent references + 20 commands
+
+**Key Difference:**
+- **Claude Code**: Full subagent system with orchestrator + skills (auto-triggering)
+- **Opencode / Droid / Ampcode**: Commands only + agent reference documentation
+
+### Start Using
+
+```bash
+# Claude Code examples
+@orchestrator help
+@1-create-prd Create a PRD for a task management app
+/brainstorming Explore authentication approaches
+/test-driven-development Implement user login
+
+# 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
+```
+
+---
+
+## 🤖 What's Included
+
+### 11 Agents
+
+**Workflow Agents (3):**
+- **1-create-prd** - Define scope with structured Product Requirement Documents
+- **2-generate-tasks** - Break PRDs into granular, actionable task lists
+- **3-process-task-list** - Execute tasks iteratively with progress tracking and review checkpoints
+
+**Specialist Agents (8):**
+- **orchestrator** - Analyze intent, coordinate workflows, route to optimal agent sequences
+- **code-developer** - Implementation, debugging, refactoring, code best practices
+- **quality-assurance** - Test architecture, quality gates, requirements traceability, risk assessment
+- **context-builder** - Initialize project context, discover documentation, create knowledge bases
+- **feature-planner** - Epics, user stories, prioritization, backlog management, retrospectives
+- **market-researcher** - Market analysis, competitive research, project discovery, brainstorming
+- **system-architect** - System design, technology selection, API design, scalability planning
+- **ui-designer** - UI/UX design, wireframes, prototypes, accessibility, design systems
+
+### 20 Commands/Skills
+
+**Auto-Triggering Skills (3)** - 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
+
+**Manual Skills/Commands (17):**
+- **brainstorming** - Structured brainstorming sessions
+- **code-review** - Implementation review against requirements
+- **condition-based-waiting** - Replace timeouts with condition polling
+- **docs-builder** - Project documentation generation
+- **root-cause-tracing** - Trace bugs backward through call stack
+- **skill-creator** - Guide for creating new skills
+- **systematic-debugging** - Four-phase debugging framework
+- **debug** - Systematic issue investigation
+- **explain** - Explain code for newcomers
+- **git-commit** - Intelligent commit creation
+- **optimize** - Performance analysis
+- **refactor** - Safe refactoring with behavior preservation
+- **review** - Comprehensive code review
+- **security** - Vulnerability scanning
+- **ship** - Pre-deployment checklist
+- **stash** - Save session context for compaction recovery or handoffs
+- **test-generate** - Generate test suites
+
+---
+
+## 📖 Documentation
+
+| 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 |
+
+---
+
+## 💡 Example Workflows
+
+**Feature Development:**
+```
+@orchestrator I need to add user authentication
+# Orchestrator routes to:
+# → market-researcher (research approaches)
+# → 1-create-prd (requirements)
+# → 2-generate-tasks (implementation tasks)
+# → 3-process-task-list (execution)
+```
+
+**Code Quality:**
+```
+@quality-assurance Review this PR before merge
+/code-review Check security and performance
+/systematic-debugging Investigate this race condition
+```
+
+**Architecture & Design:**
+```
+@system-architect Design microservices architecture
+@ui-designer Create wireframes for mobile checkout
+```
+
+---
+
+## 📊 Stats
+
+- **11** Specialized Agents
+- **20** Workflow Commands & Skills
+- **4** Supported Tools (Claude, Opencode, Ampcode, Droid)
+- **MIT** License
+
+---
+
+## 🔗 Links
+
+- **npm:** https://www.npmjs.com/package/agentflow
+- **GitHub:** https://github.com/amrhas82/agentflow
+- **Issues:** https://github.com/amrhas82/agentflow/issues
+
+---
+
+## 📄 License
+
+MIT © 2025 amrhas82
+
+---
+
+**Need help?** Check [TROUBLESHOOTING.md](TROUBLESHOOTING.md) or [open an issue](https://github.com/amrhas82/agentflow/issues)