feat(dispatcher): add mode-scoped dispatcher skills for cloud and 6.5lts

Author: Abhishek Garg

.claude-plugin/marketplace.json

@@ -11,6 +11,16 @@
       "name": "aem-edge-delivery-services",
       "source": "./skills/aem/edge-delivery-services",
       "description": "Skills for AEM Edge Delivery Services development"
+    },
+    {
+      "name": "aem-cloud-dispatcher",
+      "source": "./skills/aem/cloud/dispatcher",
+      "description": "Mode-specific Dispatcher skills for AEM as a Cloud Service workflows"
+    },
+    {
+      "name": "aem-6-5lts-dispatcher",
+      "source": "./skills/aem/6.5lts/dispatcher",
+      "description": "Mode-specific Dispatcher skills for AEM 6.5 LTS and AMS workflows"
     }
   ]
 }

README.md

@@ -12,6 +12,12 @@ Repository of Adobe skills for AI coding agents.
 
 # Install AEM Edge Delivery Services plugin (all 17 skills)
 /plugin install aem-edge-delivery-services@adobe-skills
+
+# Install AEM Cloud Dispatcher plugin
+/plugin install aem-cloud-dispatcher@adobe-skills
+
+# Install AEM 6.5 LTS Dispatcher plugin
+/plugin install aem-6-5lts-dispatcher@adobe-skills
 ```
 
 ### Vercel Skills (npx skills)
@@ -20,9 +26,17 @@ Repository of Adobe skills for AI coding agents.
 # Install all AEM Edge Delivery Services skills
 npx skills add https://github.com/adobe/skills/tree/main/skills/aem/edge-delivery-services --all
 
+# Install all AEM Cloud Dispatcher skills
+npx skills add https://github.com/adobe/skills/tree/main/skills/aem/cloud/dispatcher --all
+
+# Install all AEM 6.5 LTS Dispatcher skills
+npx skills add https://github.com/adobe/skills/tree/main/skills/aem/6.5lts/dispatcher --all
+
 # Install specific skill(s)
 npx skills add adobe/skills -s content-driven-development
 npx skills add adobe/skills -s content-driven-development building-blocks testing-blocks
+npx skills add adobe/skills -s create-dispatcher-config-cloud
+npx skills add adobe/skills -s create-dispatcher-config-ams
 
 # Install all Adobe skills (all products)
 npx skills add adobe/skills --all
@@ -42,11 +56,21 @@ gh upskill adobe/skills --all
 # Install only AEM Edge Delivery Services skills
 gh upskill adobe/skills --path skills/aem/edge-delivery-services --all
 
+# Install only AEM Cloud Dispatcher skills
+gh upskill adobe/skills --path skills/aem/cloud/dispatcher --all
+
+# Install only AEM 6.5 LTS Dispatcher skills
+gh upskill adobe/skills --path skills/aem/6.5lts/dispatcher --all
+
 # Install a specific skill
 gh upskill adobe/skills --path skills/aem/edge-delivery-services --skill content-driven-development
+gh upskill adobe/skills --path skills/aem/cloud/dispatcher --skill create-dispatcher-config-cloud
+gh upskill adobe/skills --path skills/aem/6.5lts/dispatcher --skill create-dispatcher-config-ams
 
 # List available skills in a subfolder
 gh upskill adobe/skills --path skills/aem/edge-delivery-services --list
+gh upskill adobe/skills --path skills/aem/cloud/dispatcher --list
+gh upskill adobe/skills --path skills/aem/6.5lts/dispatcher --list
 ```
 
 ## Available Skills
@@ -85,18 +109,58 @@ gh upskill adobe/skills --path skills/aem/edge-delivery-services --list
 | `generate-import-html` | Generate structured HTML |
 | `preview-import` | Preview imported content |
 
+### AEM Dispatcher
+
+Dispatcher skills are now split by upper-layer variant to avoid mode auto-detection and make extension to other AEM variants easier.
+
+#### AEM Cloud Dispatcher (`skills/aem/cloud/dispatcher`)
+
+| Skill | Description |
+|-------|-------------|
+| `create-dispatcher-config-cloud` | Create, modify, review, and harden Dispatcher/HTTPD config for AEMaaCS cloud mode |
+| `dispatcher-guided-advisory-cloud` | Documentation-backed guidance and verification planning for cloud mode |
+| `dispatcher-runtime-incident-response-cloud` | Investigate live incidents for cloud mode |
+| `dispatcher-performance-optimization-cloud` | Analyze and tune cache efficiency/latency for cloud mode |
+| `dispatcher-security-audit-cloud` | Risk-based security audits and hardening plans for cloud mode |
+
+#### AEM 6.5 LTS Dispatcher (`skills/aem/6.5lts/dispatcher`)
+
+| Skill | Description |
+|-------|-------------|
+| `create-dispatcher-config-ams` | Create, modify, review, and harden Dispatcher/HTTPD config for AEM 6.5 LTS/AMS mode |
+| `dispatcher-guided-advisory-ams` | Documentation-backed guidance and verification planning for AEM 6.5 LTS/AMS mode |
+| `dispatcher-runtime-incident-response-ams` | Investigate live incidents for AEM 6.5 LTS/AMS mode |
+| `dispatcher-performance-optimization-ams` | Analyze and tune cache efficiency/latency for AEM 6.5 LTS/AMS mode |
+| `dispatcher-security-audit-ams` | Risk-based security audits and hardening plans for AEM 6.5 LTS/AMS mode |
+
 ## Repository Structure
 
 ```
 skills/
 └── aem/
-    └── edge-delivery-services/
-        ├── .claude-plugin/
-        │   └── plugin.json
-        └── skills/
-            ├── content-driven-development/
-            ├── building-blocks/
-            └── ...
+    ├── edge-delivery-services/
+    │   ├── .claude-plugin/
+    │   │   └── plugin.json
+    │   └── skills/
+    │       ├── content-driven-development/
+    │       ├── building-blocks/
+    │       └── ...
+    ├── cloud/
+    │   └── dispatcher/
+    │       ├── .claude-plugin/
+    │       │   └── plugin.json
+    │       └── skills/
+    │           ├── create-dispatcher-config-cloud/
+    │           ├── dispatcher-guided-advisory-cloud/
+    │           └── ...
+    ├── 6.5lts/
+    │   └── dispatcher/
+    │       ├── .claude-plugin/
+    │       │   └── plugin.json
+    │       └── skills/
+    │           ├── create-dispatcher-config-ams/
+    │           ├── dispatcher-guided-advisory-ams/
+    │           └── ...
 ```
 
 ## Contributing

skills/aem/6.5lts/dispatcher/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "aem-6-5lts-dispatcher",
+  "description": "Mode-specific AEM Dispatcher skills for AEM 6.5 LTS and AMS workflows. Includes config authoring, advisory, incident response, performance optimization, and security auditing with Dispatcher MCP evidence.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Adobe"
+  },
+  "repository": "https://github.com/adobe/skills",
+  "license": "Apache-2.0",
+  "keywords": ["aem", "aem6.5", "6.5lts", "ams", "dispatcher", "httpd", "apache", "caching", "security", "adobe"]
+}

skills/aem/6.5lts/dispatcher/references/create-dispatcher-config/dispatcher-config-patterns.md

@@ -0,0 +1,69 @@
+# Dispatcher Config Patterns
+
+Use these patterns when creating or editing Dispatcher configs.
+
+## Filter Rules
+
+Preferred posture:
+1. Start deny-first (broad deny baseline).
+2. Add explicit allows per business route.
+3. Keep targeted denies for sensitive/internal paths.
+
+Guidelines:
+- Avoid broad allows such as `/url "*"` with weak constraints.
+- Prefer path + method + selector/extension constraints.
+- Keep ordering intentional to avoid accidental bypasses.
+- Keep rule numbering deterministic and aligned to existing file conventions.
+
+## Cache Rules
+
+Guidelines:
+- Cache only anonymous-safe, stable responses.
+- Exclude authenticated/personalized endpoints by default.
+- Treat query-parameter caching as opt-in and narrowly scoped.
+- Keep invalidation behavior (`statfileslevel`, flush patterns) aligned with freshness requirements.
+
+Content class defaults:
+- Static versioned assets: long-lived cache candidates.
+- HTML/content pages: conservative cache policy with revalidation.
+- API/GraphQL: short or no cache unless stability is explicit.
+
+## Vhosts and Farm Mapping
+
+Guidelines:
+- Keep host matching explicit and non-overlapping.
+- Keep vhost -> farm mapping deterministic and documented.
+- Keep canonical host/redirect behavior explicit.
+
+Pitfalls:
+- overlapping host globs sending traffic to wrong farms
+- missing redirects causing duplicate-host behavior
+
+## Rewrite Rules
+
+Guidelines:
+- Order from most specific to least specific.
+- Prevent redirect loops and over-broad matches.
+- Preserve query strings only when behavior requires it.
+- Avoid rewriting internal/system paths unless explicitly intended.
+
+## Headers and Hardening
+
+Guidelines:
+- Keep security headers consistent on public vhosts.
+- Keep cache headers aligned with cache policy.
+- Avoid exposing backend/internal headers.
+
+## Include Hygiene
+
+Before finalizing:
+- confirm each new file is reachable from active farm/vhost includes
+- follow existing numeric prefix/file order conventions
+- remove dead files and contradictory duplicate directives
+
+## Pre-Finalization Checklist
+
+- Filter posture remains least-privilege.
+- Cache and header policy are consistent.
+- Rewrite behavior is deterministic and loop-free.
+- Include graph contains all changed files exactly once where intended.

skills/aem/6.5lts/dispatcher/references/create-dispatcher-config/mcp-tool-orchestration.md

@@ -0,0 +1,47 @@
+# MCP Tool Orchestration (Core Surface)
+
+Use this map to sequence current Dispatcher MCP tools.
+
+## Tool Purpose Map
+
+- `validate`: syntax/structure validation for dispatcher/httpd/ams/runtime config checks.
+- `lint`: security/performance/best-practice analysis.
+- `sdk`: file integrity, baseline drift, and SDK-backed validation/runtime checks.
+- `trace_request`: request-stage evidence (filter, cache, log context).
+- `inspect_cache`: cache object/path evidence.
+- `monitor_metrics`: aggregated runtime signals.
+- `tail_logs`: direct log evidence.
+
+## Recommended Sequences
+
+### Config Authoring / Refactor
+
+1. Edit config files
+2. `validate`
+3. `lint`
+4. `sdk(action="check-files")`
+5. `sdk(action="diff-baseline")` when drift matters
+6. runtime tools if behavior requires runtime proof
+
+### Incident / Regression Analysis
+
+1. `trace_request`
+2. `tail_logs`
+3. `inspect_cache`
+4. `monitor_metrics`
+5. `validate` + `lint`
+6. `sdk` checks if file integrity is suspect
+
+### Release Readiness Review
+
+1. `validate`
+2. `lint`
+3. `sdk(action="check-files")`
+4. `sdk(action="diff-baseline")`
+5. Optional: `sdk(action="validate-full")` / `sdk(action="docker-test")` if environment supports it
+
+## Fallback Rules
+
+- If runtime preconditions are missing, continue with static checks and report missing evidence.
+- If SDK actions requiring external binaries/runtime fail due environment, run available checks and report limits.
+- Never report simulated success for unexecuted checks.

skills/aem/6.5lts/dispatcher/references/create-dispatcher-config/validation-playbook.md

@@ -0,0 +1,62 @@
+# Validation Playbook
+
+Use this flow after every dispatcher/httpd change.
+
+## 1) Local Project Validation
+
+When available:
+
+```bash
+cd dispatcher && ./bin/validate.sh src
+```
+
+If unavailable, run the equivalent project command and record it.
+
+## 2) MCP Static Checks
+
+Run in order:
+
+1. `validate`
+2. `lint`
+3. `sdk(action="check-files")`
+4. `sdk(action="diff-baseline")` when compliance/drift is requested
+
+## 3) MCP Runtime Checks (Conditional)
+
+Run when runtime behavior is in scope:
+
+1. `trace_request`
+2. `inspect_cache`
+3. `monitor_metrics`
+4. `tail_logs`
+
+## 4) SDK Runtime/Deep Checks (Conditional)
+
+Use only when environment supports it:
+
+- `sdk(action="validate")`
+- `sdk(action="validate-full")`
+- `sdk(action="three-phase-validate")`
+- `sdk(action="docker-test")`
+
+## 5) URL Verification Matrix
+
+Cover at least one case each:
+
+- expected allow URL
+- expected deny URL
+- expected cache-hit candidate
+- expected cache-bypass candidate
+- rewrite/redirect path (if rewrite changed)
+
+## 6) Reporting Requirements
+
+Always report:
+
+- executed checks and outcomes
+- failed checks with exact error
+- skipped checks and why
+- confirmed facts vs assumptions
+- next checks required for production confidence
+- selected test case IDs from [dispatcher-test-case-catalog.md](../dispatcher-guided-advisory/dispatcher-test-case-catalog.md)
+- rollback trigger and rollback action for behavior-changing edits

skills/aem/6.5lts/dispatcher/references/dispatcher-guided-advisory/change-risk-and-rollback-template.md

@@ -0,0 +1,41 @@
+# Change Risk And Rollback Template
+
+Use this template for any dispatcher recommendation that changes behavior.
+
+## 1) Change Summary
+
+- Change scope:
+- Target mode: `ams`
+- Files impacted:
+- User-visible impact expected:
+
+## 2) Risk Assessment
+
+| Risk Area | Assessment | Notes |
+|---|---|---|
+| Security exposure | Low / Medium / High | |
+| Availability impact | Low / Medium / High | |
+| Cache correctness | Low / Medium / High | |
+| Migration compatibility | Low / Medium / High | |
+| Rollback complexity | Low / Medium / High | |
+
+## 3) Blast Radius
+
+- Hostnames/farms affected:
+- URL classes affected:
+- Dependency assumptions:
+
+## 4) Rollback Plan
+
+- Rollback trigger criteria:
+- Immediate rollback action:
+- Validation after rollback:
+- Owner/escalation path:
+
+## 5) Verification Gate
+
+The change is production-ready only when:
+
+1. Required checks in `mode-specific-verification-matrix.md` are complete.
+2. Evidence is attached for each executed check.
+3. Open risks are explicitly accepted or remediated.