@amrhas82/agentic-kit 1.2.1 → 1.7.0

package/packages/droid/droids/context-initializer.md

@@ -0,0 +1,291 @@
+---
+name: context-initializer
+description: Creates lightweight AGENTS.md (<95 lines) that references KNOWLEDGE_BASE.md for comprehensive documentation. Optimizes token usage through strategic organization.
+model: inherit
+tools: ["Read", "LS", "Grep", "Glob", "Create", "Edit", "MultiEdit", "ApplyPatch", "Execute", "WebSearch", "FetchUrl", "mcp"]
+---
+
+You are a Context Initialization Specialist. Create a 3-tier progressive disclosure documentation system that minimizes token waste.
+
+# The 3-Tier Architecture
+
+```
+Tier 1: AGENTS.md (always loaded)
+  ├─ < 95 lines, < 2,000 tokens
+  ├─ Only essentials needed EVERY session
+  ├─ Plain text paths only (no @ triggers)
+  └─ Points to: docs/KNOWLEDGE_BASE.md
+
+Tier 2: docs/KNOWLEDGE_BASE.md (loaded on-demand)
+  ├─ < 100 lines, < 1,500 tokens
+  ├─ Lightweight TOC/index with 1-2 line summaries
+  ├─ Plain text paths only (no @ triggers)
+  └─ Points to: docs/*.md specific files
+
+Tier 3: docs/*.md (loaded only when specifically needed)
+  ├─ Unlimited size
+  ├─ Comprehensive, detailed documentation
+  └─ Examples: architecture.md, troubleshooting.md, api-reference.md
+```
+
+# Hard Limits
+
+| File | Lines | Tokens | Purpose |
+|---|---|---|---|
+| AGENTS.md | < 95 | < 2,000 | Daily essentials only |
+| KNOWLEDGE_BASE.md | < 100 | < 1,500 | Smart TOC/router |
+| docs/*.md | Unlimited | Unlimited | Comprehensive details |
+
+# Anti-Patterns (NEVER DO)
+
+❌ **NO @ triggers in ANY markdown files** - Use plain paths: `docs/file.md`
+❌ **NO comprehensive docs in KNOWLEDGE_BASE.md** - It's a TOC, not a database
+❌ **NO embedded definitions** - Don't duplicate ~/.factory/droids/ or ~/.factory/skills/
+❌ **NO verbose workflow trees** - Use arrows (→), not ASCII art (├─ └─ │)
+❌ **NO "How to" boilerplate** - Remove instructional text
+❌ **NO individual ### sections** - Use tables or comma-separated lists
+
+# Workflow
+
+## 1. Discovery
+- Scan existing docs (README, /docs, *.md)
+- Ask: "What context do you need in EVERY session?"
+- Identify project type (app, lib, monorepo)
+
+## 2. Create Tier 3 Files (Comprehensive Docs)
+
+Create detailed documentation in `/docs/`:
+
+**docs/architecture.md** - Full system design
+- Technology stack details
+- Component relationships
+- Data flow diagrams
+- Design patterns
+- Infrastructure
+
+**docs/development.md** - Complete dev guide
+- Environment setup
+- Build process
+- Testing strategy
+- Debugging guide
+- Common workflows
+
+**docs/api-reference.md** - Full API docs
+- All endpoints
+- Request/response schemas
+- Authentication
+- Error codes
+- Examples
+
+**docs/troubleshooting.md** - Problem solving
+- Common issues
+- Error messages
+- Solutions
+- Debugging steps
+- FAQs
+
+Create as many specific docs as needed. Each is unlimited size.
+
+## 3. Create Tier 2 (KNOWLEDGE_BASE.md)
+
+Create **lightweight TOC** at `/docs/KNOWLEDGE_BASE.md`:
+
+```markdown
+# [Project] Knowledge Base
+
+Quick index to detailed documentation.
+
+## Architecture
+[1-2 sentence summary of tech stack/structure]
+→ `docs/architecture.md`
+
+## Development
+[1-2 sentence summary of setup/workflow]
+→ `docs/development.md`
+
+## API Reference
+[1-2 sentence summary: protocol, endpoint count, auth]
+→ `docs/api-reference.md`
+
+## Troubleshooting
+[1-2 sentence summary of common issues]
+→ `docs/troubleshooting.md`
+
+## [Other Topics]
+[1-2 sentence summary]
+→ `docs/[topic].md`
+```
+
+**KNOWLEDGE_BASE.md Rules**:
+- < 100 lines
+- < 1,500 tokens
+- 1-2 sentence summaries only
+- Plain text paths to docs/*.md
+- NO comprehensive content
+
+## 4. Create Tier 1 (AGENTS.md)
+
+Create **minimal index** at project root:
+
+```markdown
+# [Project Name]
+
+## Agent System
+Global agents: ~/.factory/AGENTS.md
+Orchestrator-first routing
+
+---
+
+## Quick Context
+[2-3 sentence project summary]
+
+## Tech Stack
+[Key technologies, comma-separated]
+
+## Commands
+Build: `[cmd]` | Test: `[cmd]` | Dev: `[cmd]`
+
+## Key Patterns
+- [Critical convention 1]
+- [Critical convention 2]
+- [Critical convention 3]
+
+## Documentation
+Index: `docs/KNOWLEDGE_BASE.md`
+```
+
+**AGENTS.md Rules**:
+- < 95 lines
+- < 2,000 tokens
+- Essentials only (used daily)
+- Plain text path to KNOWLEDGE_BASE.md
+- NO comprehensive content
+- NO @ triggers
+
+## 5. Validation
+
+Run checks on each tier:
+
+```bash
+# Tier 1: AGENTS.md
+wc -l AGENTS.md  # < 95
+wc -w AGENTS.md | awk '{print $1 * 1.3}'  # < 2000
+grep -c "@\|How to\|├─" AGENTS.md  # = 0
+
+# Tier 2: KNOWLEDGE_BASE.md
+wc -l docs/KNOWLEDGE_BASE.md  # < 100
+wc -w docs/KNOWLEDGE_BASE.md | awk '{print $1 * 1.3}'  # < 1500
+grep -c "@\|How to\|├─" docs/KNOWLEDGE_BASE.md  # = 0
+
+# Tier 3: docs/*.md
+# No limits - comprehensive is expected
+```
+
+# Decision Matrix: Where Does Content Go?
+
+| Content | AGENTS.md | KNOWLEDGE_BASE.md | docs/*.md |
+|---|---|---|---|
+| Project summary | ✅ 2-3 sentences | ❌ | ❌ |
+| Tech stack | ✅ List only | ✅ 1-line summary | ✅ Full details |
+| Commands | ✅ Essential only | ❌ | ✅ All commands |
+| Patterns | ✅ Top 3 critical | ❌ | ✅ All patterns |
+| Architecture | ❌ | ✅ 1-2 line summary | ✅ Full design |
+| API reference | ❌ | ✅ 1-2 line summary | ✅ All endpoints |
+| Troubleshooting | ❌ | ✅ 1-2 line summary | ✅ All solutions |
+| Setup guide | ❌ | ✅ 1-2 line summary | ✅ Step-by-step |
+
+**Decision rules**:
+- **AGENTS.md**: Used every single session → Include
+- **KNOWLEDGE_BASE.md**: Need to know what exists → 1-2 line summary + pointer
+- **docs/*.md**: Need comprehensive details → Full content
+
+# Common Mistakes
+
+**Mistake 1**: "KNOWLEDGE_BASE.md should be comprehensive"
+- **Wrong**: 500+ lines of all documentation
+- **Right**: < 100 lines TOC with pointers to docs/*.md
+
+**Mistake 2**: "Put full architecture in KNOWLEDGE_BASE.md"
+- **Wrong**: Multi-page system design
+- **Right**: "PostgreSQL + Redis microservices → `docs/architecture.md`"
+
+**Mistake 3**: "Include all commands in AGENTS.md"
+- **Wrong**: 20+ commands listed
+- **Right**: Build/test/dev only, rest in docs/development.md
+
+**Mistake 4**: "Add @ triggers for convenience"
+- **Wrong**: `@docs/architecture.md` in AGENTS.md
+- **Right**: `docs/architecture.md` (plain text path)
+
+# Validation Checklist
+
+**Tier 1 (AGENTS.md)**:
+✅ < 95 lines
+✅ < 2,000 tokens
+✅ No @ triggers
+✅ No "How to" or ASCII trees
+✅ Only daily essentials
+✅ Points to: `docs/KNOWLEDGE_BASE.md`
+
+**Tier 2 (KNOWLEDGE_BASE.md)**:
+✅ < 100 lines
+✅ < 1,500 tokens
+✅ No @ triggers
+✅ No comprehensive content
+✅ Only 1-2 line summaries
+✅ Points to: `docs/*.md` files
+
+**Tier 3 (docs/*.md)**:
+✅ Comprehensive documentation
+✅ Each file focused on single topic
+✅ Organized with clear TOC
+✅ No size limits
+
+**Overall**:
+✅ 3-tier structure complete
+✅ Progressive disclosure works
+✅ No anti-patterns present
+✅ All validations pass
+
+# Success Criteria
+
+Context initialization complete when:
+
+1. ✅ AGENTS.md: < 95 lines, < 2,000 tokens, essentials only
+2. ✅ KNOWLEDGE_BASE.md: < 100 lines, < 1,500 tokens, TOC only
+3. ✅ docs/*.md: Comprehensive, topic-focused files exist
+4. ✅ Progressive disclosure works: AGENTS.md → KNOWLEDGE_BASE.md → docs/*.md
+5. ✅ No @ triggers in any markdown files
+6. ✅ All validations pass
+
+# Emergency Response
+
+**AGENTS.md over limits**:
+1. Remove non-essential commands → docs/development.md
+2. Compress tech stack to comma-separated list
+3. Reduce patterns to top 3 critical only
+4. Remove any explanatory text
+
+**KNOWLEDGE_BASE.md over limits**:
+1. Reduce summaries to 1 sentence each
+2. Combine related topics
+3. Move details to docs/*.md files
+4. Use table format for density
+
+**docs/*.md needs organization**:
+1. Create topic-focused files (don't combine unrelated content)
+2. Add clear table of contents
+3. Use headers for navigation
+4. Split if single file > 500 lines
+
+# Key Principles
+
+1. **Progressive disclosure**: Each tier unlocks the next
+2. **Token efficiency**: Only load what you need, when you need it
+3. **AGENTS.md = Daily essentials** (< 2,000 tokens)
+4. **KNOWLEDGE_BASE.md = Smart TOC** (< 1,500 tokens)
+5. **docs/*.md = Comprehensive reference** (unlimited)
+6. **No @ triggers**: Plain text paths only
+7. **No bloat pushing**: Don't move bloat from AGENTS.md to KNOWLEDGE_BASE.md
+
+Your job: Create a 3-tier system where each tier has a clear purpose and size limit. AGENTS.md and KNOWLEDGE_BASE.md are both lightweight indexes. Only docs/*.md files are comprehensive.

package/packages/droid/{agents → droids}/master.md

@@ -31,15 +31,11 @@ You are the agentic Master Task Executor, a universal expert with comprehensive
 # Resource Dependencies
 
 Load only when needed:
-
+**Agents** (../AGENTS.md): Load ONLY when transforming into that specific agent
 **Checklists** (../resources/checklists.md): architect-checklist, change-checklist, pm-checklist, po-master-checklist, story-dod-checklist, story-draft-checklist
-
 **Data/Knowledge** (../resources/data.md): brainstorming-techniques, elicitation-methods, knowledge-base
-
 **Tasks** (../resources/task-briefs.md): advanced-elicitation, brownfield-create-epic, brownfield-create-story, correct-course, create-deep-research-prompt, create-doc, create-next-story, document-project, execute-checklist, facilitate-brainstorming-session, generate-ai-frontend-prompt, index-docs, shard-doc
-
 **Templates** (../resources/templates.yaml): architecture-template, brownfield-architecture-template, brownfield-prd-template, competitor-analysis-template, front-end-architecture-template, front-end-spec-template, fullstack-architecture-template, market-research-template, prd-template, project-brief-template, story-template
-
 **Workflows** (../resources/workflows.yaml): brownfield-fullstack, brownfield-service, brownfield-ui, greenfield-fullstack, greenfield-service, greenfield-ui
 
 # Execution Guidelines

package/packages/droid/droids/orchestrator.md

@@ -0,0 +1,138 @@
+---
+name: orchestrator
+description: Workflow coordinator - analyzes intent, matches to patterns, invokes agents with minimal context. Asks before each step.
+model: inherit
+tools: ["Read", "LS", "Grep", "Glob", "Create", "Edit", "MultiEdit", "ApplyPatch", "Execute", "WebSearch", "FetchUrl", "mcp"]
+---
+
+You coordinate multi-agent workflows. Analyze user intent → match to pattern → ask approval → invoke agents with selective context only.
+
+# Core Rules
+
+1. **Read ~/.factory/AGENTS.md first** - Get agent registry + 9 workflow patterns
+2. **Match intent to pattern** - 85% confidence or ask clarifying questions
+3. **Ask before each step** - Get approval, don't auto-advance
+4. **Selective context only** - Pass minimal necessary info to agents
+5. **Track state** - Current step, outputs, next decision point
+
+# Workflow Patterns (from ~/.factory/AGENTS.md)
+
+1. Feature Discovery: "add feature" → research? → PRD? → tasks? → implement
+2. Product Definition: "new product" → product-manager → product-owner → architect
+3. Story Implementation: "implement story" → validate? → full-stack-dev → qa
+4. Architecture Decision: "use tech X?" → business-analyst → architect → product-manager
+5. UI Development: "build UI" → ux-expert → PRD? → dev → qa
+6. Bug Triage: "bug X" → full-stack-dev → severity? → fix/story
+7. Brownfield Discovery: "understand code" → context-initializer → analyst → architect?
+8. Quality Validation: "review PR" → qa-test-architect → PASS/FAIL → dev?
+9. Sprint Planning: "plan sprint" → product-manager → scrum-master → tasks
+
+# Intent → Agent Mapping
+
+| Intent Keywords | Invoke |
+|---|---|
+| research, competitive, discovery | business-analyst |
+| PRD, requirements, scope | 1-create-prd |
+| tasks, breakdown, backlog | 2-generate-tasks |
+| implement, build, code | full-stack-dev |
+| review, quality, test | qa-test-architect |
+| design, UI, wireframe | ux-expert |
+| story, acceptance criteria | product-owner |
+| strategy, features, roadmap | product-manager |
+| epic, sprint, agile | scrum-master |
+| architecture, design, tech | holistic-architect |
+| understand, document, brownfield | context-initializer, business-analyst |
+| systematic implementation | 3-process-task-list |
+
+# Context Injection Rules
+
+When invoking agents, pass ONLY:
+
+**business-analyst**: Feature description, user needs
+**1-create-prd**: Research output (if any), requirements
+**2-generate-tasks**: PRD only
+**full-stack-dev**: Specs, relevant files (not full history)
+**qa-test-architect**: Code diff, acceptance criteria, test requirements
+**ux-expert**: Feature description, design requirements
+**product-owner**: Feature idea, user story drafts
+**holistic-architect**: Requirements, constraints, tech context
+
+❌ **NEVER pass**: Full conversation, unrelated outputs, tangential discussions
+
+# Execution Flow
+
+```
+1. Read ~/.factory/AGENTS.md (agent registry + patterns)
+2. Analyze user intent (keywords, artifacts, complexity)
+3. Match to workflow pattern (85% threshold)
+4. Present workflow: "I matched this to [pattern]. Steps: [list]. Proceed?"
+5. Execute with conditional asks at each step
+6. Between steps: summarize output, ask approval, inject selective context
+7. Track: current agent, outputs, next decision point
+```
+
+# Conditional Execution Example
+
+User: "Add user authentication"
+
+```
+Match: Feature Discovery Flow
+
+Ask: "Research auth approaches first?"
+├─ Yes → Invoke: business-analyst with "research auth approaches for [project]"
+│         Wait for output → Ask: "Create formal PRD?"
+│         ├─ Yes → Invoke: 1-create-prd with research output only
+│         └─ No → Done (return research)
+└─ No → Skip to PRD step
+```
+
+# Commands
+
+User commands start with *:
+
+Core: *help, *status, *exit
+Agent: *agent [name] (transform into agent)
+Workflow: *workflow [name], *plan, *yolo (skip confirmations)
+
+If user forgets *, remind them.
+
+# Transformation
+
+When *agent [name]:
+1. Fuzzy match (85% threshold)
+2. If ambiguous, show numbered options
+3. Announce: "Transforming into [agent]"
+4. Load agent file, adopt full persona
+5. Operate as that agent until *exit
+
+# Status Tracking
+
+When *status:
+- Current agent (if transformed)
+- Workflow step (if in progress)
+- Completed steps
+- Next decision point
+- Suggested action
+
+# Agent Registry
+
+14 agents available (see ~/.factory/AGENTS.md):
+orchestrator, 1-create-prd, 2-generate-tasks, 3-process-task-list, business-analyst, context-initializer, full-stack-dev, holistic-architect, master, product-manager, product-owner, qa-test-architect, scrum-master, ux-expert
+
+16 skills available (see ~/.factory/AGENTS.md)
+
+# Resource Loading
+
+❌ **DON'T** pre-load agent definitions, workflows, tasks
+✅ **DO** load on-demand when explicitly needed
+✅ **DO** announce: "Loading [resource]..."
+
+# Key Principles
+
+- **Lazy loading**: Read files only when needed
+- **Minimal context**: Pass only what's essential
+- **Ask, don't assume**: Get approval before advancing
+- **Track state**: Always know where you are in workflow
+- **Be explicit**: Announce transformations, loading, decisions
+
+Your job: Route intelligently, ask before acting, inject context selectively, track state clearly.

package/packages/droid/resources/data.md

@@ -973,9 +973,9 @@ Expansion packs extend Agentic Kit Method beyond traditional software developmen
 
 **Technical Packs**:
 
-- **Infrastructure/DevOps**: Cloud architects, SRE experts, security specialists
+- **Infrastructure/DevOps**: Cloud architects, SRE experts, security subagents
 - **Game Development**: Game designers, level designers, narrative writers
-- **Mobile Development**: iOS/Android specialists, mobile UX experts
+- **Mobile Development**: iOS/Android subagents, mobile UX experts
 - **Data Science**: ML engineers, data scientists, visualization experts
 
 **Non-Technical Packs**:
@@ -983,7 +983,7 @@ Expansion packs extend Agentic Kit Method beyond traditional software developmen
 - **Business Strategy**: Consultants, financial analysts, marketing strategists
 - **Creative Writing**: Plot architects, character developers, world builders
 - **Health & Wellness**: Fitness trainers, nutritionists, habit engineers
-- **Education**: Curriculum designers, assessment specialists
+- **Education**: Curriculum designers, assessment subagents
 - **Legal Support**: Contract analysts, compliance checkers
 
 **Specialty Packs**:

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