@amrhas82/agentic-kit 1.2.1 → 1.7.0

package/packages/claude/subagentic-manual.md

@@ -0,0 +1,170 @@
+# Subagent Kits Manual
+
+Complete ready-to-use package of AI subagents, skills, and task templates for **Claude Code**, **OpenCode**, **Amp**, and **Droid**. Production-tested agent definitions from Simple + BMAD methodologies, zero configuration needed.
+
+---
+
+## 🚀 Quick Start
+
+Clone the toolkit:
+```bash
+git clone https://github.com/amrhas82/agentic-toolkit
+cd agentic-toolkit
+```
+
+Install and invoke for your platform:
+
+| Platform | Installation | Invocation |
+|----------|--------------|-----------|
+| **Claude Code** | `cp -rv ai/subagentic/claude/* ~/.claude/` | Automatic via orchestrator (or `@agent-name`, `As agent-name, ...`) |
+| **OpenCode** | `cp -rv ai/subagentic/opencode/* ~/.config/opencode/` | Automatic via orchestrator (or `@agent-name` or `As agent-name, ...` )|
+| **Amp** | `cp -rv ai/subagentic/ampcode/* ~/.config/amp/` | Automatic via orchestrator (or `As agent-name, ...` )|
+| **Droid** | `cp -rv ai/subagentic/droid/* ~/.factory/` + enable in `~/.factory/settings.json` | Automatic via orchestrator (or `invoke droid agent_name`) |
+
+---
+
+## 📦 What's Included
+
+**Per-kit contents** (14 subagents + 22 skills + 20+ tasks):
+- **3 Workflow Subagents** – Three-phase development: 1-Create PRD → 2-Generate Tasks → 3-Process Task List
+- **11 Specialist Subagents** – Expert roles (UX, QA, Product, Dev, Architecture, etc.)
+- **22 Reusable Skills** – Code creation, testing, debugging, docs, design, file processing
+- **20+ Task Templates** – Validation, planning, development, documentation, specialized workflows
+- **Zero Configuration** – Ready to use immediately
+---
+
+## 🤖 14 Subagents
+
+### Workflow Phase Agents (3)
+| Agent | Purpose | Token Load* |
+|-------|---------|------------|
+| **1-create-prd** | Create Product Requirement Documents with structured scope and requirements | ~889 tokens |
+| **2-generate-tasks** | Break PRDs into granular, actionable task lists | ~1,029 tokens |
+| **3-process-task-list** | Execute tasks iteratively with built-in review and progress tracking | ~1,004 tokens |
+
+**Recommended Workflow:** PRD → Tasks → Process → Complete
+
+### Specialist Agents (11)
+| Agent | Purpose | Token Load*    |
+|-------|---------|----------------|
+| **ux-expert** | UI/UX design, wireframes, prototypes, front-end specifications | ~1,113 tokens  |
+| **scrum-master** | User stories, epic management, agile process guidance | ~927 tokens    |
+| **qa-test-architect** | Test architecture, quality gates, code review feedback | ~1,351 tokens  |
+| **product-owner** | Backlog management, story refinement, acceptance criteria | ~1,299 tokens  |
+| **product-manager** | PRDs, product strategy, feature prioritization, roadmaps | ~1,243 tokens  |
+| **full-stack-dev** | Code implementation, debugging, refactoring | ~1,025 tokens  |
+| **holistic-architect** | System design, architecture docs, API design, scalability | ~1,427 tokens  |
+| **business-analyst** | Market research, competitive analysis, project discovery | ~1,295 tokens  |
+| **orchestrator** | Workflow coordination, multi-agent task management, automatic routing | ~902 tokens    |
+| **master** | Comprehensive expertise across all domains, universal executor | ~1,073 tokens  |
+| **context-initializer** | Project context setup, documentation discovery, creates CLAUDE.md with agent system | ~1,614 tokens |
+
+**\*Progressive Disclosure:** Token loads shown are **full agent sizes when invoked**. Your base conversation only loads lightweight stubs (~50-90 tokens each, ~967 tokens total for all 14 agents). Full agent content loads only when you invoke that specific agent via `Task` tool. Check with `/context` command to see actual current usage.
+
+---
+
+## 🛠 22 Reusable Skills
+
+### Development & Testing (7)
+| Skill | Purpose | Token Load* |
+|-------|---------|------------|
+| **test-driven-development** | Write tests first, red-green-refactor cycle ensures tests verify behavior | ~2,434 tokens |
+| **testing-anti-patterns** | Avoid mock testing, test-only code, and mindless mocking | ~2,101 tokens |
+| **code-review** | Structured code review workflow before merging | ~846 tokens |
+| **systematic-debugging** | Four-phase debugging: investigate → analyze → hypothesize → implement | ~163 tokens |
+| **root-cause-tracing** | Trace bugs backward through call stack to find original trigger | ~1,400 tokens |
+| **condition-based-waiting** | Replace timeouts with polling to eliminate flaky tests | ~937 tokens |
+| **verification-before-completion** | Verify claims with evidence before marking tasks complete | ~1,050 tokens |
+
+### Design & Creativity (5)
+| Skill | Purpose | Token Load* |
+|-------|---------|------------|
+| **algorithmic-art** | Create generative art using p5.js with seeded randomness | ~4,942 tokens |
+| **canvas-design** | Create visual art in PNG/PDF with design philosophy | ~2,984 tokens |
+| **artifacts-builder** | Build React/TypeScript/Tailwind/shadcn artifacts with Parcel bundling | ~769 tokens |
+| **theme-factory** | Apply 10 curated professional themes with color/font pairings | ~781 tokens |
+| **slack-gif-creator** | Create optimized animated GIFs for Slack | ~4,285 tokens |
+
+### Office & Document Processing (4)
+| Skill | Purpose | Token Load* |
+|-------|---------|------------|
+| **pdf** | Extract/create PDFs, merge/split, handle forms and tables | ~2,359 tokens |
+| **docx** | Create/edit Word documents with tracked changes and comments | ~2,537 tokens |
+| **pptx** | Create/edit PowerPoint with design-first approach and HTML conversion | ~6,387 tokens |
+| **xlsx** | Create/edit spreadsheets with formulas, formatting, and data analysis | ~2,658 tokens |
+
+### Strategy & Communication (4)
+| Skill | Purpose | Token Load* |
+|-------|---------|------------|
+| **brainstorming** | Collaborative design through questioning and exploration | ~640 tokens |
+| **internal-comms** | Write internal communications with company-approved formats | ~377 tokens |
+| **brand-guidelines** | Apply Anthropic's official brand colors and typography | ~558 tokens |
+| **mcp-builder** | Create MCP servers for LLM-service integration | ~3,388 tokens |
+
+### Specialized (2)
+| Skill | Purpose | Token Load* |
+|-------|---------|------------|
+| **webapp-testing** | Test local web apps with Playwright – verify, debug, screenshot | ~978 tokens |
+| **skill-creator** | Create custom skills extending Claude's capabilities | ~2,886 tokens |
+
+**\*Progressive Disclosure:** Token loads shown are **full skill sizes when activated**. Skills load on-demand via the `Skill` tool when you invoke them (e.g., `/pdf`, `/brainstorming`). Until activated, skills consume minimal tokens as slash command metadata (~3.1k tokens total for all 22 skills). Use `/context` to monitor actual usage.
+
+---
+
+## 📋 20+ Reusable Task Templates
+
+Pre-built workflows for common development patterns (available in all kits):
+
+### Quality & Validation (5)
+- **validate-next-story** – Validate user story before implementation
+- **review-story** – Comprehensive story review and feedback
+- **trace-requirements** – Map requirements to tests
+- **qa-gate** – Quality gate decision (PASS/CONCERNS/FAIL)
+- **apply-qa-fixes** – Apply QA feedback to code
+
+### Planning & Analysis (4)
+- **risk-profile** – Risk assessment matrix and mitigation
+- **nfr-assess** – Non-functional requirements validation
+- **advanced-elicitation** – Structured requirements discovery
+- **test-design** – Test scenario creation
+
+### Development (4)
+- **create-next-story** – Generate user story from requirements
+- **create-brownfield-story** – Story template for existing codebase
+- **brownfield-create-epic** – Epic breakdown for existing systems
+- **correct-course** – Realign strategy or approach mid-project
+
+### Documentation (4)
+- **create-doc** – Generate documentation from code/context
+- **shard-doc** – Break large documents into focused sections
+- **index-docs** – Create documentation indices
+- **document-project** – Comprehensive project documentation
+
+### Specialized (3+)
+- **generate-ai-frontend-prompt** – v0 and Lovable UI generation prompts
+- **facilitate-brainstorming-session** – Structured brainstorming workflow
+- **create-deep-research-prompt** – Deep research and analysis workflow
+- **execute-checklist** – Universal checklist execution
+
+---
+
+## 🎯 How to Use This Package
+
+### Claude Code (Orchestrator-First Pattern)
+1. **Install** – `cp -rv ai/subagentic/claude/* ~/.claude/`
+2. **Make requests naturally** – "Add authentication feature", "Review this code", "Plan next sprint"
+3. **Orchestrator routes automatically** – Matches intent to optimal workflow, asks conditional questions
+4. **Bypass when needed** – `@agent-name` or `As agent-name, ...` for direct agent access
+5. **9 workflow patterns** – Pre-defined sequences in CLAUDE.md (Feature Discovery, Architecture Decision, etc.)
+
+**Key files:**
+- `~/.claude/CLAUDE.md` – Agent system with orchestrator-first routing and 9 workflows
+- `~/.claude/agents/` – 14 specialist agents (orchestrator, 1-create-prd, full-stack-dev, qa, etc.)
+- Project `CLAUDE.md` – Auto-created by context-initializer with agent system reminder
+
+### Other Platforms
+1. **Clone and Install** – Copy files to your CLI's config directory
+2. **Start with Workflow** – Use 1-create-prd → 2-generate-tasks → 3-process-task-list
+3. **Add Specialists** – Invoke agents by name for specific domain expertise
+4. **Leverage Skills** – Use skills within agents for specialized capabilities
+5. **Reuse Tasks** – Apply pre-built task templates for common patterns

package/packages/claude/variants.json

@@ -8,7 +8,8 @@
       "1-create-prd",
       "2-generate-tasks",
       "3-process-task-list",
-      "master"
+      "master",
+      "context-initializer"
     ],
     "skills": [
       "docx",
@@ -36,7 +37,8 @@
       "qa-test-architect",
       "full-stack-dev",
       "business-analyst",
-      "ux-expert"
+      "ux-expert",
+      "context-initializer"
     ],
     "skills": [
       "docx",