@amrhas82/agentic-kit 1.2.1 → 1.7.0

package/packages/opencode/opencode.jsonc

@@ -3,7 +3,7 @@
   "agent": {
       "1-create-prd": {
       "prompt": "{file:./agent/1-create-prd.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -13,7 +13,7 @@
     },
         "2-generate-tasks": {
       "prompt": "{file:./agent/2-generate-tasks.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -23,7 +23,7 @@
     },
         "3-process-task-list": {
       "prompt": "{file:./agent/3-process-task-list.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -33,7 +33,7 @@
     },   
     "ux-expert": {
       "prompt": "{file:./agent/ux-expert.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -43,7 +43,7 @@
     },
     "scrum-master": {
       "prompt": "{file:./agent/scrum-master.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -53,7 +53,7 @@
     },
     "qa-test-architecht": {
       "prompt": "{file:./agent/qa-test-architect.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -63,7 +63,7 @@
     },
     "product-owner": {
       "prompt": "{file:./agent/product-owner.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -73,7 +73,7 @@
     },
     "product-manager": {
       "prompt": "{file:./agent/product-manager.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -83,7 +83,7 @@
     },
     "full-stack-dev": {
       "prompt": "{file:./agent/full-stack-dev.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -103,7 +103,7 @@
     },
     "master": {
       "prompt": "{file:./agent/master.md}",
-      "mode": "all",
+      "mode": "primary",
       "tools": {
         "write": true,
         "edit": true,
@@ -113,17 +113,27 @@
     },
     "holistic-architect": {
       "prompt": "{file:./agent/holistic-architect.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
         "bash": true
       },
       "description": "Use for system design, architecture documents, technology selection, API design, and infrastructure planning"
+      },
+          "context-initializer": {
+      "prompt": "{file:./agent/context-initializer.md}",
+      "mode": "subagent",
+      "tools": {
+        "write": true,
+        "edit": true,
+        "bash": true
+      },
+      "description": "Use to initialize Opencode context for new/existing projects, discover and organize documentation for optimal token-efficient memory"
     },
     "business-analyst": {
       "prompt": "{file:./agent/business-analyst.md}",
-      "mode": "all",
+      "mode": "subagent",
       "tools": {
         "write": true,
         "edit": true,
@@ -134,91 +144,91 @@
   },
   "command": {
     "xlsx": {
-      "template": "{file:./xlsx.md}",
+      "template": "{file:./command/xlsx.md}",
       "description": "Create, edit, and analyze spreadsheets with formulas, formatting, data analysis, and visualization"
     },
     "webapp-testing": {
-      "template": "{file:./webapp-testing.md}",
+      "template": "{file:./command/webapp-testing.md}",
       "description": "Test local web applications using Playwright - verify functionality, debug UI, capture screenshots"
     },
     "systematic-debugging": {
-      "template": "{file:./systematic-debugging.md}",
+      "template": "{file:./command/systematic-debugging.md}",
       "description": "Systematic four-phase debugging framework - investigate root cause before any fixes"
     },
     "slack-gif-creator": {
-      "template": "{file:./slack-gif-creator.md}",
+      "template": "{file:./command/slack-gif-creator.md}",
       "description": "Create animated GIFs optimized for Slack with size validation and composable animation primitives"
     },
     "verification-before-completion": {
-      "template": "{file:./verification-before-completion.md}",
+      "template": "{file:./command/verification-before-completion.md}",
       "description": "Verify work meets requirements before marking complete - prevents incomplete deliverables"
     },
     "skill-creator": {
-      "template": "{file:./skill-creator.md}",
+      "template": "{file:./command/skill-creator.md}",
       "description": "Create reusable skills with proper structure, validation, and documentation"
     },
     "test-driven-development": {
-      "template": "{file:./test-driven-development.md}",
+      "template": "{file:./command/test-driven-development.md}",
       "description": "Write test first, watch it fail, write minimal code to pass - ensures tests actually verify behavior"
     },
     "testing-anti-patterns": {
-      "template": "{file:./testing-anti-patterns.md}",
+      "template": "{file:./command/testing-anti-patterns.md}",
       "description": "Identify and avoid common testing anti-patterns that create fragile, useless tests"
     },
     "theme-factory": {
-      "template": "{file:./theme-factory.md}",
+      "template": "{file:./command/theme-factory.md}",
       "description": "Generate consistent themes with proper color systems, typography, and spacing"
     },
     "root-cause-tracing": {
-      "template": "{file:./root-cause-tracing.md}",
+      "template": "{file:./command/root-cause-tracing.md}",
       "description": "Trace issues to their root cause using systematic investigation techniques"
     },
     "internal-comms": {
-      "template": "{file:./internal-comms.md}",
+      "template": "{file:./command/internal-comms.md}",
       "description": "Structure internal communications for clarity, actionability, and team alignment"
     },
     "pdf": {
-      "template": "{file:./pdf.md}",
+      "template": "{file:./command/pdf.md}",
       "description": "Create, edit, and analyze PDF documents with proper formatting and structure"
     },
     "mcp-builder": {
-      "template": "{file:./mcp-builder.md}",
+      "template": "{file:./command/mcp-builder.md}",
       "description": "Build Model Context Protocol servers with proper tool definitions and error handling"
     },
     "condition-based-waiting": {
-      "template": "{file:./condition-based-waiting.md}",
+      "template": "{file:./command/condition-based-waiting.md}",
       "description": "Implement robust waiting mechanisms based on conditions rather than fixed delays"
     },
     "pptx": {
-      "template": "{file:./pptx.md}",
+      "template": "{file:./command/pptx.md}",
       "description": "Create professional PowerPoint presentations with proper structure and design"
     },
     "docx": {
-      "template": "{file:./docx.md}",
+      "template": "{file:./command/docx.md}",
       "description": "Create and edit Word documents with proper formatting and structure"
     },
     "brand-guidelines": {
-      "template": "{file:./brand-guidelines.md}",
+      "template": "{file:./command/brand-guidelines.md}",
       "description": "Establish comprehensive brand guidelines with visual identity and usage rules"
     },
     "brainstorming": {
-      "template": "{file:./brainstorming.md}",
+      "template": "{file:./command/brainstorming.md}",
       "description": "Facilitate structured brainstorming sessions with proven techniques and frameworks"
     },
     "canvas-design": {
-      "template": "{file:./canvas-design.md}",
+      "template": "{file:./command/canvas-design.md}",
       "description": "Design visual canvases for business models, user journeys, and strategic planning"
     },
     "artifacts-builder": {
-      "template": "{file:./artifacts-builder.md}",
+      "template": "{file:./command/artifacts-builder.md}",
       "description": "Build structured artifacts with proper validation, formatting, and documentation"
     },
     "algorithmic-art": {
-      "template": "{file:./algorithmic-art.md}",
+      "template": "{file:./command/algorithmic-art.md}",
       "description": "Generate algorithmic art with mathematical patterns and aesthetic principles"
     },
     "code-review": {
-      "template": "{file:./code-review.md}",
+      "template": "{file:./command/code-review.md}",
       "description": "Conduct thorough code reviews with focus on quality, security, and maintainability"
     }
   }

package/packages/opencode/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/opencode/variants.json

@@ -1,14 +1,15 @@
 {
   "lite": {
     "name": "Lite",
-    "description": "Essential workflow agents with core document and debugging skills optimized for CLI",
-    "useCase": "Users wanting comprehensive CLI workflow management with essential document processing and debugging capabilities",
-    "targetUsers": "Beginners, evaluators, terminal-focused developers wanting balanced features",
+    "description": "Essential workflow agents with core document and debugging skills",
+    "useCase": "Users wanting comprehensive workflow management with essential document processing and debugging capabilities",
+    "targetUsers": "Beginners, evaluators, users wanting balanced features with moderate footprint",
     "agents": [
       "1-create-prd",
       "2-generate-tasks",
       "3-process-task-list",
-      "master"
+      "master",
+      "context-initializer"
     ],
     "skills": [
       "docx",
@@ -24,9 +25,9 @@
   },
   "standard": {
     "name": "Standard",
-    "description": "Complete workflow and development team with enhanced testing and validation skills for CLI workflows",
-    "useCase": "Professional terminal-based development with full team coordination, testing, and comprehensive skill set",
-    "targetUsers": "Professional CLI developers, teams, quality-focused terminal users",
+    "description": "Complete workflow and development team with enhanced testing and validation skills",
+    "useCase": "Professional development with full team coordination, testing, and comprehensive skill set",
+    "targetUsers": "Professional developers, teams, quality-focused users",
     "agents": [
       "1-create-prd",
       "2-generate-tasks",
@@ -36,7 +37,8 @@
       "qa-test-architect",
       "full-stack-dev",
       "business-analyst",
-      "ux-expert"
+      "ux-expert",
+      "context-initializer"
     ],
     "skills": [
       "docx",
@@ -56,9 +58,9 @@
   },
   "pro": {
     "name": "Pro",
-    "description": "Complete installation with all capabilities optimized for advanced CLI-based development and automation",
-    "useCase": "Full-featured installation for users needing all AI codegen, document processing, testing, and terminal automation capabilities",
-    "targetUsers": "Power users, enterprises, DevOps teams, terminal workflow enthusiasts",
+    "description": "Complete installation with all capabilities including advanced development, testing, and creative skills",
+    "useCase": "Full-featured installation for users needing all AI codegen, document processing, testing, debugging, and creative capabilities",
+    "targetUsers": "Power users, enterprises, teams requiring comprehensive feature set",
     "agents": "*",
     "skills": "*",
     "resources": "*",

package/packages/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